@nahisaho/shikigami-mcp-server 1.7.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (114) hide show
  1. package/README.md +29 -0
  2. package/dist/cache/__tests__/global.test.d.ts +6 -0
  3. package/dist/cache/__tests__/global.test.d.ts.map +1 -0
  4. package/dist/cache/__tests__/global.test.js +269 -0
  5. package/dist/cache/__tests__/global.test.js.map +1 -0
  6. package/dist/cache/__tests__/manager.test.d.ts +6 -0
  7. package/dist/cache/__tests__/manager.test.d.ts.map +1 -0
  8. package/dist/cache/__tests__/manager.test.js +286 -0
  9. package/dist/cache/__tests__/manager.test.js.map +1 -0
  10. package/dist/cache/__tests__/semantic.test.d.ts +6 -0
  11. package/dist/cache/__tests__/semantic.test.d.ts.map +1 -0
  12. package/dist/cache/__tests__/semantic.test.js +271 -0
  13. package/dist/cache/__tests__/semantic.test.js.map +1 -0
  14. package/dist/cache/__tests__/store.test.d.ts +6 -0
  15. package/dist/cache/__tests__/store.test.d.ts.map +1 -0
  16. package/dist/cache/__tests__/store.test.js +289 -0
  17. package/dist/cache/__tests__/store.test.js.map +1 -0
  18. package/dist/cache/global.d.ts +140 -0
  19. package/dist/cache/global.d.ts.map +1 -0
  20. package/dist/cache/global.js +260 -0
  21. package/dist/cache/global.js.map +1 -0
  22. package/dist/cache/index.d.ts +10 -0
  23. package/dist/cache/index.d.ts.map +1 -0
  24. package/dist/cache/index.js +10 -0
  25. package/dist/cache/index.js.map +1 -0
  26. package/dist/cache/manager.d.ts +146 -0
  27. package/dist/cache/manager.d.ts.map +1 -0
  28. package/dist/cache/manager.js +229 -0
  29. package/dist/cache/manager.js.map +1 -0
  30. package/dist/cache/semantic.d.ts +164 -0
  31. package/dist/cache/semantic.d.ts.map +1 -0
  32. package/dist/cache/semantic.js +241 -0
  33. package/dist/cache/semantic.js.map +1 -0
  34. package/dist/cache/store.d.ts +98 -0
  35. package/dist/cache/store.d.ts.map +1 -0
  36. package/dist/cache/store.js +469 -0
  37. package/dist/cache/store.js.map +1 -0
  38. package/dist/cache/types.d.ts +171 -0
  39. package/dist/cache/types.d.ts.map +1 -0
  40. package/dist/cache/types.js +8 -0
  41. package/dist/cache/types.js.map +1 -0
  42. package/dist/config/types.d.ts +67 -0
  43. package/dist/config/types.d.ts.map +1 -1
  44. package/dist/config/types.js +30 -0
  45. package/dist/config/types.js.map +1 -1
  46. package/dist/tools/__tests__/multilingual-search.test.d.ts +7 -0
  47. package/dist/tools/__tests__/multilingual-search.test.d.ts.map +1 -0
  48. package/dist/tools/__tests__/multilingual-search.test.js +71 -0
  49. package/dist/tools/__tests__/multilingual-search.test.js.map +1 -0
  50. package/dist/tools/search/recovery/__tests__/logger.test.d.ts +8 -0
  51. package/dist/tools/search/recovery/__tests__/logger.test.d.ts.map +1 -0
  52. package/dist/tools/search/recovery/__tests__/logger.test.js +249 -0
  53. package/dist/tools/search/recovery/__tests__/logger.test.js.map +1 -0
  54. package/dist/tools/search/recovery/__tests__/manager-logger.test.d.ts +8 -0
  55. package/dist/tools/search/recovery/__tests__/manager-logger.test.d.ts.map +1 -0
  56. package/dist/tools/search/recovery/__tests__/manager-logger.test.js +158 -0
  57. package/dist/tools/search/recovery/__tests__/manager-logger.test.js.map +1 -0
  58. package/dist/tools/search/recovery/index.d.ts +31 -2
  59. package/dist/tools/search/recovery/index.d.ts.map +1 -1
  60. package/dist/tools/search/recovery/index.js +51 -7
  61. package/dist/tools/search/recovery/index.js.map +1 -1
  62. package/dist/tools/search/recovery/logger.d.ts +149 -0
  63. package/dist/tools/search/recovery/logger.d.ts.map +1 -0
  64. package/dist/tools/search/recovery/logger.js +218 -0
  65. package/dist/tools/search/recovery/logger.js.map +1 -0
  66. package/dist/tools/search.d.ts +48 -0
  67. package/dist/tools/search.d.ts.map +1 -1
  68. package/dist/tools/search.js +152 -0
  69. package/dist/tools/search.js.map +1 -1
  70. package/dist/tools/visit/recovery/__tests__/index.test.d.ts +10 -0
  71. package/dist/tools/visit/recovery/__tests__/index.test.d.ts.map +1 -0
  72. package/dist/tools/visit/recovery/__tests__/index.test.js +239 -0
  73. package/dist/tools/visit/recovery/__tests__/index.test.js.map +1 -0
  74. package/dist/tools/visit/recovery/__tests__/wayback.test.d.ts +8 -0
  75. package/dist/tools/visit/recovery/__tests__/wayback.test.d.ts.map +1 -0
  76. package/dist/tools/visit/recovery/__tests__/wayback.test.js +271 -0
  77. package/dist/tools/visit/recovery/__tests__/wayback.test.js.map +1 -0
  78. package/dist/tools/visit/recovery/index.d.ts +126 -0
  79. package/dist/tools/visit/recovery/index.d.ts.map +1 -0
  80. package/dist/tools/visit/recovery/index.js +203 -0
  81. package/dist/tools/visit/recovery/index.js.map +1 -0
  82. package/dist/tools/visit/recovery/wayback.d.ts +101 -0
  83. package/dist/tools/visit/recovery/wayback.d.ts.map +1 -0
  84. package/dist/tools/visit/recovery/wayback.js +140 -0
  85. package/dist/tools/visit/recovery/wayback.js.map +1 -0
  86. package/dist/tools/visit.d.ts +33 -0
  87. package/dist/tools/visit.d.ts.map +1 -1
  88. package/dist/tools/visit.js +127 -1
  89. package/dist/tools/visit.js.map +1 -1
  90. package/package.json +7 -3
  91. package/shikigami.config.example.yaml +9 -0
  92. package/src/cache/__tests__/global.test.ts +340 -0
  93. package/src/cache/__tests__/manager.test.ts +353 -0
  94. package/src/cache/__tests__/semantic.test.ts +331 -0
  95. package/src/cache/__tests__/store.test.ts +369 -0
  96. package/src/cache/global.ts +351 -0
  97. package/src/cache/index.ts +10 -0
  98. package/src/cache/manager.ts +325 -0
  99. package/src/cache/semantic.ts +368 -0
  100. package/src/cache/store.ts +555 -0
  101. package/src/cache/types.ts +189 -0
  102. package/src/config/types.ts +108 -0
  103. package/src/tools/__tests__/multilingual-search.test.ts +88 -0
  104. package/src/tools/search/recovery/__tests__/logger.test.ts +334 -0
  105. package/src/tools/search/recovery/__tests__/manager-logger.test.ts +199 -0
  106. package/src/tools/search/recovery/index.ts +67 -9
  107. package/src/tools/search/recovery/logger.ts +351 -0
  108. package/src/tools/search.ts +212 -0
  109. package/src/tools/visit/recovery/__tests__/index.test.ts +297 -0
  110. package/src/tools/visit/recovery/__tests__/wayback.test.ts +344 -0
  111. package/src/tools/visit/recovery/index.ts +312 -0
  112. package/src/tools/visit/recovery/wayback.ts +210 -0
  113. package/src/tools/visit.ts +159 -2
  114. package/vitest.config.ts +22 -0
@@ -2,11 +2,14 @@
2
2
  * SearchRecoveryManager
3
3
  *
4
4
  * TSK-006: SearchRecoveryManager
5
+ * TSK-1-002: RecoveryLogger連携
5
6
  * REQ-SRCH-003: 検索失敗時の自動リカバリー
7
+ * REQ-SRCH-005-03: フォールバックログ
6
8
  * DES-SRCH-003: 検索リカバリーシステム設計
7
9
  */
8
10
  import { SynonymStrategy, SimplifyStrategy, TranslateStrategy } from './strategies/index.js';
9
11
  import { DEFAULT_SEARCH_RECOVERY_CONFIG } from '../../../config/types.js';
12
+ import { RecoveryLogger } from './logger.js';
10
13
  /**
11
14
  * 検索リカバリーマネージャー
12
15
  *
@@ -16,9 +19,12 @@ export class SearchRecoveryManager {
16
19
  strategies;
17
20
  config;
18
21
  logEntries = [];
22
+ logger;
19
23
  constructor(config) {
20
- this.config = { ...DEFAULT_SEARCH_RECOVERY_CONFIG, ...config };
24
+ const { logger, loggerConfig, ...recoveryConfig } = config ?? {};
25
+ this.config = { ...DEFAULT_SEARCH_RECOVERY_CONFIG, ...recoveryConfig };
21
26
  this.strategies = this.initializeStrategies();
27
+ this.logger = logger ?? new RecoveryLogger(loggerConfig);
22
28
  }
23
29
  /**
24
30
  * 戦略を初期化
@@ -64,15 +70,16 @@ export class SearchRecoveryManager {
64
70
  const attemptStart = Date.now();
65
71
  try {
66
72
  const results = await this.executeWithTimeout(() => searchFn(alternative.query), deadline - Date.now());
73
+ const attemptDurationMs = Date.now() - attemptStart;
67
74
  const attempt = {
68
75
  query: alternative,
69
76
  resultCount: results.length,
70
- durationMs: Date.now() - attemptStart,
77
+ durationMs: attemptDurationMs,
71
78
  timestamp: new Date(),
72
79
  };
73
80
  attempts.push(attempt);
74
81
  // ログ記録
75
- this.logRecoveryAttempt(originalQuery, alternative, results.length, results.length > 0);
82
+ this.logRecoveryAttempt(originalQuery, alternative, results.length, results.length > 0, attemptDurationMs);
76
83
  // 結果がある場合は成功
77
84
  if (results.length > 0) {
78
85
  return {
@@ -87,16 +94,17 @@ export class SearchRecoveryManager {
87
94
  }
88
95
  }
89
96
  catch (error) {
97
+ const attemptDurationMs = Date.now() - attemptStart;
90
98
  const attempt = {
91
99
  query: alternative,
92
100
  resultCount: 0,
93
- durationMs: Date.now() - attemptStart,
101
+ durationMs: attemptDurationMs,
94
102
  error: error instanceof Error ? error.message : String(error),
95
103
  timestamp: new Date(),
96
104
  };
97
105
  attempts.push(attempt);
98
106
  // ログ記録
99
- this.logRecoveryAttempt(originalQuery, alternative, 0, false);
107
+ this.logRecoveryAttempt(originalQuery, alternative, 0, false, attemptDurationMs);
100
108
  }
101
109
  }
102
110
  // すべての試行が失敗
@@ -150,7 +158,8 @@ export class SearchRecoveryManager {
150
158
  /**
151
159
  * リカバリー試行をログに記録
152
160
  */
153
- logRecoveryAttempt(originalQuery, alternative, resultCount, success) {
161
+ logRecoveryAttempt(originalQuery, alternative, resultCount, success, durationMs) {
162
+ // 旧形式のログエントリ(後方互換性のため維持)
154
163
  const entry = {
155
164
  originalQuery,
156
165
  alternativeQuery: alternative.query,
@@ -160,11 +169,23 @@ export class SearchRecoveryManager {
160
169
  timestamp: new Date(),
161
170
  };
162
171
  this.logEntries.push(entry);
172
+ // 新形式のRecoveryLoggerにも記録
173
+ const extendedEntry = {
174
+ originalQuery,
175
+ alternativeQuery: alternative.query,
176
+ strategy: alternative.strategy,
177
+ resultCount,
178
+ success,
179
+ timestamp: new Date(),
180
+ durationMs,
181
+ confidence: alternative.confidence,
182
+ };
183
+ this.logger.log(extendedEntry);
163
184
  // stderr にログ出力
164
185
  console.error(`[SearchRecovery] ${success ? '✓' : '✗'} "${originalQuery}" → "${alternative.query}" (${alternative.strategy}) = ${resultCount}件`);
165
186
  }
166
187
  /**
167
- * ログエントリを取得
188
+ * ログエントリを取得(旧形式)
168
189
  */
169
190
  getLogEntries() {
170
191
  return [...this.logEntries];
@@ -174,6 +195,7 @@ export class SearchRecoveryManager {
174
195
  */
175
196
  clearLog() {
176
197
  this.logEntries.length = 0;
198
+ this.logger.clear();
177
199
  }
178
200
  /**
179
201
  * 有効な戦略一覧を取得
@@ -181,8 +203,30 @@ export class SearchRecoveryManager {
181
203
  getActiveStrategies() {
182
204
  return this.strategies.map((s) => s.name);
183
205
  }
206
+ /**
207
+ * 統計情報を取得
208
+ * @returns RecoveryStats
209
+ */
210
+ getStats() {
211
+ return this.logger.getStats();
212
+ }
213
+ /**
214
+ * 高頻度失敗クエリを取得
215
+ * @param minFailures 最小失敗回数(省略時はデフォルトの閾値を使用)
216
+ */
217
+ getHighFrequencyQueries(minFailures) {
218
+ return this.logger.getHighFrequencyQueries(minFailures);
219
+ }
220
+ /**
221
+ * RecoveryLoggerインスタンスを取得
222
+ * @returns RecoveryLogger
223
+ */
224
+ getLogger() {
225
+ return this.logger;
226
+ }
184
227
  }
185
228
  // 型エクスポート
186
229
  export * from './types.js';
187
230
  export * from './strategies/index.js';
231
+ export { RecoveryLogger } from './logger.js';
188
232
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/search/recovery/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/search/recovery/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,149 @@
1
+ /**
2
+ * RecoveryLogger - フォールバックログ統計・警告機能
3
+ *
4
+ * TSK-1-001: RecoveryLogger実装
5
+ * REQ-SRCH-005-03: フォールバックログ
6
+ * DES-SRCH-005-03: RecoveryLogger設計
7
+ */
8
+ import type { RecoveryLogEntry } from './types.js';
9
+ /**
10
+ * 戦略別統計
11
+ */
12
+ export interface StrategyStats {
13
+ /** 戦略名 */
14
+ strategy: string;
15
+ /** 試行回数 */
16
+ attempts: number;
17
+ /** 成功回数 */
18
+ successCount: number;
19
+ /** 成功率 */
20
+ successRate: number;
21
+ /** 平均処理時間(ms) */
22
+ avgDurationMs: number;
23
+ }
24
+ /**
25
+ * クエリ失敗情報
26
+ */
27
+ export interface QueryFailureInfo {
28
+ /** クエリ文字列 */
29
+ query: string;
30
+ /** 失敗回数 */
31
+ failureCount: number;
32
+ /** 最後の失敗日時 */
33
+ lastFailure: Date;
34
+ /** 試行した戦略一覧 */
35
+ strategies: string[];
36
+ }
37
+ /**
38
+ * リカバリー統計
39
+ */
40
+ export interface RecoveryStats {
41
+ /** 総試行回数 */
42
+ totalAttempts: number;
43
+ /** 成功回数 */
44
+ successCount: number;
45
+ /** 失敗回数 */
46
+ failureCount: number;
47
+ /** 成功率 */
48
+ successRate: number;
49
+ /** 平均処理時間(ms) */
50
+ avgDurationMs: number;
51
+ /** 戦略別統計 */
52
+ byStrategy: Record<string, StrategyStats>;
53
+ /** 高頻度失敗クエリ */
54
+ highFrequencyFailures: QueryFailureInfo[];
55
+ /** 統計期間開始 */
56
+ periodStart: Date;
57
+ /** 統計期間終了 */
58
+ periodEnd: Date;
59
+ }
60
+ /**
61
+ * 拡張ログエントリ(処理時間を含む)
62
+ */
63
+ export interface ExtendedLogEntry extends RecoveryLogEntry {
64
+ /** 一意のID */
65
+ id: string;
66
+ /** リカバリータイプ */
67
+ type?: 'search' | 'visit';
68
+ /** 処理時間(ms) */
69
+ durationMs: number;
70
+ /** エラーメッセージ(失敗時) */
71
+ error?: string;
72
+ /** 代替クエリの信頼度 */
73
+ confidence?: number;
74
+ }
75
+ /**
76
+ * ロガー設定
77
+ */
78
+ export interface RecoveryLoggerConfig {
79
+ /** 統計出力間隔(試行回数) */
80
+ statsInterval: number;
81
+ /** 高頻度失敗警告閾値 */
82
+ warnThreshold: number;
83
+ /** 最大ログエントリ保持数 */
84
+ maxEntries: number;
85
+ /** 統計集計期間(ms) */
86
+ statsPeriodMs: number;
87
+ }
88
+ /**
89
+ * デフォルト設定
90
+ */
91
+ export declare const DEFAULT_LOGGER_CONFIG: RecoveryLoggerConfig;
92
+ /**
93
+ * リカバリーログ管理クラス
94
+ *
95
+ * フォールバック試行のログ記録、統計計算、高頻度失敗クエリの検出を行う
96
+ */
97
+ export declare class RecoveryLogger {
98
+ private readonly entries;
99
+ private readonly config;
100
+ private readonly queryFailureMap;
101
+ private attemptCount;
102
+ private idCounter;
103
+ constructor(config?: Partial<RecoveryLoggerConfig>);
104
+ /**
105
+ * UUIDライクなIDを生成
106
+ */
107
+ private generateId;
108
+ /**
109
+ * ログエントリを記録
110
+ */
111
+ log(entry: Omit<ExtendedLogEntry, 'id'>): void;
112
+ /**
113
+ * 失敗マップを更新
114
+ */
115
+ private updateFailureMap;
116
+ /**
117
+ * 高頻度失敗をチェックして警告
118
+ */
119
+ private checkHighFrequencyFailures;
120
+ /**
121
+ * 統計をstderrに出力
122
+ */
123
+ private outputStats;
124
+ /**
125
+ * 統計情報を取得
126
+ */
127
+ getStats(): RecoveryStats;
128
+ /**
129
+ * 高頻度失敗クエリを取得
130
+ */
131
+ getHighFrequencyQueries(threshold?: number): QueryFailureInfo[];
132
+ /**
133
+ * ログをJSON形式でエクスポート
134
+ */
135
+ exportToJson(): string;
136
+ /**
137
+ * ログエントリを取得
138
+ */
139
+ getEntries(): ExtendedLogEntry[];
140
+ /**
141
+ * ログをクリア
142
+ */
143
+ clear(): void;
144
+ /**
145
+ * 試行回数を取得
146
+ */
147
+ getAttemptCount(): number;
148
+ }
149
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/tools/search/recovery/logger.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,218 @@
1
+ /**
2
+ * RecoveryLogger - フォールバックログ統計・警告機能
3
+ *
4
+ * TSK-1-001: RecoveryLogger実装
5
+ * REQ-SRCH-005-03: フォールバックログ
6
+ * DES-SRCH-005-03: RecoveryLogger設計
7
+ */
8
+ /**
9
+ * デフォルト設定
10
+ */
11
+ export const DEFAULT_LOGGER_CONFIG = {
12
+ statsInterval: 100,
13
+ warnThreshold: 5,
14
+ maxEntries: 1000,
15
+ statsPeriodMs: 24 * 60 * 60 * 1000, // 24時間
16
+ };
17
+ /**
18
+ * リカバリーログ管理クラス
19
+ *
20
+ * フォールバック試行のログ記録、統計計算、高頻度失敗クエリの検出を行う
21
+ */
22
+ export class RecoveryLogger {
23
+ entries = [];
24
+ config;
25
+ queryFailureMap = new Map();
26
+ attemptCount = 0;
27
+ idCounter = 0;
28
+ constructor(config) {
29
+ this.config = { ...DEFAULT_LOGGER_CONFIG, ...config };
30
+ }
31
+ /**
32
+ * UUIDライクなIDを生成
33
+ */
34
+ generateId() {
35
+ this.idCounter++;
36
+ const timestamp = Date.now().toString(36);
37
+ const counter = this.idCounter.toString(36).padStart(4, '0');
38
+ return `${timestamp}-${counter}`;
39
+ }
40
+ /**
41
+ * ログエントリを記録
42
+ */
43
+ log(entry) {
44
+ const fullEntry = {
45
+ ...entry,
46
+ id: this.generateId(),
47
+ };
48
+ this.entries.push(fullEntry);
49
+ this.attemptCount++;
50
+ // 最大エントリ数を超えたら古いものを削除
51
+ if (this.entries.length > this.config.maxEntries) {
52
+ this.entries.shift();
53
+ }
54
+ // 失敗マップを更新
55
+ if (!entry.success) {
56
+ this.updateFailureMap(entry);
57
+ }
58
+ // 定期的に統計を出力
59
+ if (this.attemptCount % this.config.statsInterval === 0) {
60
+ this.outputStats();
61
+ }
62
+ // 高頻度失敗をチェック
63
+ this.checkHighFrequencyFailures(entry.originalQuery);
64
+ }
65
+ /**
66
+ * 失敗マップを更新
67
+ */
68
+ updateFailureMap(entry) {
69
+ const existing = this.queryFailureMap.get(entry.originalQuery);
70
+ if (existing) {
71
+ existing.failureCount++;
72
+ existing.lastFailure = entry.timestamp;
73
+ if (!existing.strategies.includes(entry.strategy)) {
74
+ existing.strategies.push(entry.strategy);
75
+ }
76
+ }
77
+ else {
78
+ this.queryFailureMap.set(entry.originalQuery, {
79
+ query: entry.originalQuery,
80
+ failureCount: 1,
81
+ lastFailure: entry.timestamp,
82
+ strategies: [entry.strategy],
83
+ });
84
+ }
85
+ }
86
+ /**
87
+ * 高頻度失敗をチェックして警告
88
+ */
89
+ checkHighFrequencyFailures(query) {
90
+ const failure = this.queryFailureMap.get(query);
91
+ if (failure && failure.failureCount === this.config.warnThreshold) {
92
+ console.error(`[RecoveryLogger] ⚠️ High frequency failure detected: "${query}" (${failure.failureCount} failures)`);
93
+ }
94
+ }
95
+ /**
96
+ * 統計をstderrに出力
97
+ */
98
+ outputStats() {
99
+ const stats = this.getStats();
100
+ console.error(`[RecoveryLogger] 📊 Stats: ${stats.totalAttempts} attempts, ${(stats.successRate * 100).toFixed(1)}% success rate`);
101
+ }
102
+ /**
103
+ * 統計情報を取得
104
+ */
105
+ getStats() {
106
+ const now = new Date();
107
+ const periodStart = new Date(now.getTime() - this.config.statsPeriodMs);
108
+ // 期間内のエントリをフィルタ
109
+ const recentEntries = this.entries.filter((e) => e.timestamp >= periodStart);
110
+ if (recentEntries.length === 0) {
111
+ return {
112
+ totalAttempts: 0,
113
+ successCount: 0,
114
+ failureCount: 0,
115
+ successRate: 0,
116
+ avgDurationMs: 0,
117
+ byStrategy: {},
118
+ highFrequencyFailures: [],
119
+ periodStart,
120
+ periodEnd: now,
121
+ };
122
+ }
123
+ const successCount = recentEntries.filter((e) => e.success).length;
124
+ const failureCount = recentEntries.length - successCount;
125
+ const totalDurationMs = recentEntries.reduce((sum, e) => sum + (e.durationMs || 0), 0);
126
+ // 戦略別統計
127
+ const byStrategy = {};
128
+ for (const entry of recentEntries) {
129
+ if (!byStrategy[entry.strategy]) {
130
+ byStrategy[entry.strategy] = {
131
+ strategy: entry.strategy,
132
+ attempts: 0,
133
+ successCount: 0,
134
+ successRate: 0,
135
+ avgDurationMs: 0,
136
+ };
137
+ }
138
+ const stats = byStrategy[entry.strategy];
139
+ stats.attempts++;
140
+ if (entry.success) {
141
+ stats.successCount++;
142
+ }
143
+ }
144
+ // 戦略別の成功率と平均時間を計算
145
+ for (const strategyName of Object.keys(byStrategy)) {
146
+ const stats = byStrategy[strategyName];
147
+ stats.successRate = stats.attempts > 0 ? stats.successCount / stats.attempts : 0;
148
+ const strategyEntries = recentEntries.filter((e) => e.strategy === strategyName);
149
+ const strategyDuration = strategyEntries.reduce((sum, e) => sum + (e.durationMs || 0), 0);
150
+ stats.avgDurationMs =
151
+ strategyEntries.length > 0
152
+ ? strategyDuration / strategyEntries.length
153
+ : 0;
154
+ }
155
+ // 高頻度失敗クエリを取得
156
+ const highFrequencyFailures = this.getHighFrequencyQueries(this.config.warnThreshold);
157
+ return {
158
+ totalAttempts: recentEntries.length,
159
+ successCount,
160
+ failureCount,
161
+ successRate: recentEntries.length > 0 ? successCount / recentEntries.length : 0,
162
+ avgDurationMs: recentEntries.length > 0 ? totalDurationMs / recentEntries.length : 0,
163
+ byStrategy,
164
+ highFrequencyFailures,
165
+ periodStart,
166
+ periodEnd: now,
167
+ };
168
+ }
169
+ /**
170
+ * 高頻度失敗クエリを取得
171
+ */
172
+ getHighFrequencyQueries(threshold) {
173
+ const minFailures = threshold ?? this.config.warnThreshold;
174
+ return Array.from(this.queryFailureMap.values())
175
+ .filter((info) => info.failureCount >= minFailures)
176
+ .sort((a, b) => b.failureCount - a.failureCount);
177
+ }
178
+ /**
179
+ * ログをJSON形式でエクスポート
180
+ */
181
+ exportToJson() {
182
+ const stats = this.getStats();
183
+ return JSON.stringify({
184
+ period: `${stats.periodStart.toISOString()}/${stats.periodEnd.toISOString()}`,
185
+ stats: {
186
+ totalAttempts: stats.totalAttempts,
187
+ successCount: stats.successCount,
188
+ failureCount: stats.failureCount,
189
+ successRate: stats.successRate,
190
+ avgDurationMs: stats.avgDurationMs,
191
+ },
192
+ byStrategy: stats.byStrategy,
193
+ highFrequencyFailures: stats.highFrequencyFailures,
194
+ entries: this.entries.slice(-100), // 最新100件
195
+ }, null, 2);
196
+ }
197
+ /**
198
+ * ログエントリを取得
199
+ */
200
+ getEntries() {
201
+ return [...this.entries];
202
+ }
203
+ /**
204
+ * ログをクリア
205
+ */
206
+ clear() {
207
+ this.entries.length = 0;
208
+ this.queryFailureMap.clear();
209
+ this.attemptCount = 0;
210
+ }
211
+ /**
212
+ * 試行回数を取得
213
+ */
214
+ getAttemptCount() {
215
+ return this.attemptCount;
216
+ }
217
+ }
218
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../src/tools/search/recovery/logger.ts"],"names":[],"mappings":"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"}
@@ -70,4 +70,52 @@ export declare function searchDuckDuckGo(query: string, maxResults?: number): Pr
70
70
  * @internal
71
71
  */
72
72
  export declare function resetSearchInfrastructure(): void;
73
+ import type { MultilingualSearchConfig } from '../config/types.js';
74
+ /**
75
+ * 多言語検索結果の型定義
76
+ */
77
+ export interface MultilingualSearchResult {
78
+ query: {
79
+ original: string;
80
+ translated: string | null;
81
+ detectedLanguage: 'ja' | 'en' | 'mixed';
82
+ };
83
+ results: Array<{
84
+ url: string;
85
+ title: string;
86
+ snippet: string;
87
+ sourceLanguage: 'ja' | 'en';
88
+ relevanceScore?: number;
89
+ }>;
90
+ metadata: {
91
+ totalResults: number;
92
+ japaneseResults: number;
93
+ englishResults: number;
94
+ duplicatesRemoved: number;
95
+ executionTimeMs: number;
96
+ };
97
+ }
98
+ /**
99
+ * 言語検出 (TSK-002)
100
+ * REQ-SRCH-004-01: 言語検出
101
+ */
102
+ export declare function detectLanguage(query: string): 'ja' | 'en' | 'mixed';
103
+ /**
104
+ * クエリ翻訳 (TSK-003)
105
+ * REQ-SRCH-004-02: クエリ翻訳
106
+ * v1.7.0のBUILTIN_DICTIONARYを拡張して使用
107
+ */
108
+ export declare function translateQuery(query: string, customDictionary?: Record<string, string>): string | null;
109
+ /**
110
+ * URL正規化 (TSK-004)
111
+ * REQ-SRCH-004-04: 結果マージと重複排除
112
+ */
113
+ export declare function normalizeUrl(url: string): string;
114
+ /**
115
+ * 多言語並列検索 (TSK-005)
116
+ * REQ-SRCH-004-03: 並列検索実行
117
+ *
118
+ * 設定で`multilingualSearch.enabled: true`の場合に使用
119
+ */
120
+ export declare function searchMultilingual(query: string, config?: Partial<MultilingualSearchConfig>): Promise<MultilingualSearchResult>;
73
121
  //# sourceMappingURL=search.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,KAAK,EAEV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAqKD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,wBAAwB,CAAC,CAGnC;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC;IACT,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAuCD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAG1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAGvD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CA+FzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD"}
1
+ {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}