@nahisaho/shikigami-mcp-server 1.7.0 → 1.10.0

package/src/cache/types.ts

@@ -0,0 +1,189 @@
+/**
+ * Cache Module Types
+ * v1.0.0 - REQ-CACHE-001
+ *
+ * キャッシュシステムの型定義
+ */
+
+/**
+ * キャッシュエントリのメタデータ
+ */
+export interface CacheEntryMeta {
+  /** エントリ作成日時 (ISO 8601) */
+  createdAt: string;
+  /** 最終アクセス日時 (ISO 8601) */
+  lastAccessedAt: string;
+  /** 有効期限 (ISO 8601) */
+  expiresAt: string;
+  /** アクセス回数 */
+  accessCount: number;
+  /** データサイズ (bytes) */
+  size: number;
+  /** ソース識別子 (search, visit, embedding等) */
+  source: CacheSource;
+  /** クエリのハッシュ */
+  queryHash: string;
+  /** 元のキャッシュキー */
+  originalKey: string;
+  /** 関連タグ */
+  tags?: string[];
+}
+
+/**
+ * キャッシュエントリ
+ */
+export interface CacheEntry<T = unknown> {
+  /** キャッシュキー */
+  key: string;
+  /** キャッシュされた値 */
+  value: T;
+  /** メタデータ */
+  meta: CacheEntryMeta;
+}
+
+/**
+ * キャッシュソース種別
+ */
+export type CacheSource = 'search' | 'visit' | 'embedding' | 'analysis' | 'other';
+
+/**
+ * キャッシュ設定
+ */
+export interface CacheConfig {
+  /** キャッシュを有効にするか */
+  enabled: boolean;
+  /** 最大エントリ数 */
+  maxEntries: number;
+  /** デフォルトTTL (秒) */
+  defaultTtlSeconds: number;
+  /** 最大キャッシュサイズ (bytes) */
+  maxSizeBytes: number;
+  /** キャッシュディレクトリパス */
+  cacheDir: string;
+  /** ソース別TTL設定 */
+  ttlBySource?: Partial<Record<CacheSource, number>>;
+  /** グローバルキャッシュを使用するか */
+  useGlobalCache?: boolean;
+}
+
+/**
+ * キャッシュ統計情報
+ */
+export interface CacheStats {
+  /** 総エントリ数 */
+  totalEntries: number;
+  /** 総サイズ (bytes) */
+  totalSizeBytes: number;
+  /** キャッシュヒット数 */
+  hits: number;
+  /** キャッシュミス数 */
+  misses: number;
+  /** ヒット率 (0-1) */
+  hitRate: number;
+  /** 削除されたエントリ数 (TTL期限切れ) */
+  expiredEvictions: number;
+  /** 削除されたエントリ数 (LRU) */
+  lruEvictions: number;
+  /** ソース別統計 */
+  bySource: Partial<Record<CacheSource, SourceCacheStats>>;
+  /** 統計開始日時 */
+  statsStartedAt: string;
+}
+
+/**
+ * ソース別キャッシュ統計
+ */
+export interface SourceCacheStats {
+  /** エントリ数 */
+  entries: number;
+  /** サイズ (bytes) */
+  sizeBytes: number;
+  /** ヒット数 */
+  hits: number;
+  /** ミス数 */
+  misses: number;
+}
+
+/**
+ * キャッシュ操作結果
+ */
+export interface CacheResult<T = unknown> {
+  /** キャッシュヒットしたか */
+  hit: boolean;
+  /** 取得した値 (hitの場合) */
+  value?: T;
+  /** メタデータ (hitの場合) */
+  meta?: CacheEntryMeta;
+  /** キャッシュキー */
+  key: string;
+}
+
+/**
+ * キャッシュ保存オプション
+ */
+export interface CacheSetOptions {
+  /** TTL (秒)。省略時はデフォルトTTL */
+  ttlSeconds?: number;
+  /** タグ */
+  tags?: string[];
+  /** ソース */
+  source?: CacheSource;
+}
+
+/**
+ * キャッシュクエリオプション
+ */
+export interface CacheQueryOptions {
+  /** ソースでフィルタ */
+  source?: CacheSource;
+  /** タグでフィルタ (AND条件) */
+  tags?: string[];
+  /** 期限切れを含むか */
+  includeExpired?: boolean;
+  /** 最大取得数 */
+  limit?: number;
+}
+
+/**
+ * LRU削除候補
+ */
+export interface LruCandidate {
+  /** キャッシュキー */
+  key: string;
+  /** 最終アクセス日時 */
+  lastAccessedAt: string;
+  /** サイズ */
+  size: number;
+}
+
+/**
+ * キャッシュストアインターフェース
+ */
+export interface ICacheStore {
+  /** エントリを取得 */
+  get<T = unknown>(key: string): Promise<CacheResult<T>>;
+
+  /** エントリを保存 */
+  set<T = unknown>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+
+  /** エントリを削除 */
+  delete(key: string): Promise<boolean>;
+
+  /** 全エントリを削除 */
+  clear(): Promise<void>;
+
+  /** キーが存在するか確認 */
+  has(key: string): Promise<boolean>;
+
+  /** 統計情報を取得 */
+  getStats(): Promise<CacheStats>;
+
+  /** 期限切れエントリを削除 */
+  evictExpired(): Promise<number>;
+
+  /** LRUポリシーでエントリを削除 */
+  evictLru(targetSizeBytes: number): Promise<number>;
+
+  /** エントリを検索 */
+  query(options: CacheQueryOptions): Promise<CacheEntry[]>;
+}

package/src/config/types.ts

@@ -311,6 +311,16 @@ export interface ShikigamiConfig {
   /** PDF解析設定 (v1.7.0) */
   pdfParsing?: PdfParsingConfig;
 
+  // v1.8.0: 新機能設定
+  /** 多言語並列検索設定 (v1.8.0) */
+  multilingualSearch?: MultilingualSearchConfig;
+
+  /** ナレッジ継承設定 (v1.8.0) */
+  knowledgeInheritance?: KnowledgeInheritanceConfig;
+
+  /** ページ訪問リカバリー設定 (v1.10.0) */
+  visitRecovery?: VisitRecoveryConfig;
+
   /** カスタム設定（拡張用） */
   custom?: Record<string, unknown>;
 }
@@ -415,3 +425,101 @@ export const DEFAULT_PDF_PARSING_CONFIG: Required<PdfParsingConfig> = {
   timeoutMs: 60000,
   tempDir: '/tmp/shikigami-pdf',
 };
+
+// ============================================================
+// v1.8.0: 多言語並列検索設定 (REQ-SRCH-004)
+// ============================================================
+
+/**
+ * 多言語並列検索設定 (v1.8.0)
+ * REQ-SRCH-004: 多言語並列検索
+ */
+export interface MultilingualSearchConfig {
+  /** 多言語検索を有効にするか */
+  enabled: boolean;
+  /** 優先言語（結果マージ時の優先順位） */
+  priorityLanguage?: 'ja' | 'en';
+  /** 言語別最大結果数 */
+  maxResults?: number;
+  /** 検索タイムアウト（ms） */
+  timeoutMs?: number;
+  /** カスタム翻訳辞書（v1.7.0辞書に追加） */
+  customDictionary?: Record<string, string>;
+}
+
+/**
+ * デフォルト多言語検索設定
+ */
+export const DEFAULT_MULTILINGUAL_SEARCH_CONFIG: Required<MultilingualSearchConfig> = {
+  enabled: true,
+  priorityLanguage: 'ja',
+  maxResults: 20,
+  timeoutMs: 10000,
+  customDictionary: {},
+};
+
+// ============================================================
+// v1.8.0: ナレッジ継承設定 (REQ-KM-004)
+// ============================================================
+
+/**
+ * ナレッジ継承設定 (v1.8.0)
+ * REQ-KM-004: ナレッジ継承の自動実行
+ */
+export interface KnowledgeInheritanceConfig {
+  /** ナレッジ継承を有効にするか */
+  enabled: boolean;
+  /** 鮮度閾値（日数、これを超えるとSTALE警告） */
+  freshnessThresholdDays?: number;
+  /** 関連プロジェクト自動検出を有効にするか */
+  autoDetectRelated?: boolean;
+  /** 継承対象ファイルパターン */
+  includePatterns?: string[];
+  /** 継承除外ファイルパターン */
+  excludePatterns?: string[];
+}
+
+/**
+ * デフォルトナレッジ継承設定
+ */
+export const DEFAULT_KNOWLEDGE_INHERITANCE_CONFIG: Required<KnowledgeInheritanceConfig> = {
+  enabled: true,
+  freshnessThresholdDays: 30,
+  autoDetectRelated: true,
+  includePatterns: ['research/**/*.md', 'reports/**/*.md'],
+  excludePatterns: ['**/draft-*.md', '**/temp-*.md'],
+};
+
+// ============================================================
+// v1.10.0: ページ訪問リカバリー設定 (REQ-SRCH-004)
+// ============================================================
+
+/**
+ * ページ訪問リカバリー設定 (v1.10.0)
+ * REQ-SRCH-004-01: visit失敗時フォールバック
+ * REQ-SRCH-004-02: 自動リトライ
+ */
+export interface VisitRecoveryConfig {
+  /** リカバリーを有効にするか */
+  enabled: boolean;
+  /** 最大リトライ回数 */
+  maxRetries?: number;
+  /** リトライ間隔（ms） */
+  retryDelayMs?: number;
+  /** タイムアウト（ms） */
+  timeoutMs?: number;
+  /** Wayback Machine を使用するか */
+  enableWayback?: boolean;
+}
+
+/**
+ * デフォルトページ訪問リカバリー設定
+ */
+export const DEFAULT_VISIT_RECOVERY_CONFIG: Required<VisitRecoveryConfig> = {
+  enabled: true,
+  maxRetries: 2,
+  retryDelayMs: 1000,
+  timeoutMs: 30000,
+  enableWayback: true,
+};
+

package/src/tools/__tests__/multilingual-search.test.ts

@@ -0,0 +1,88 @@
+/**
+ * @file 多言語検索ユニットテスト
+ * @description v1.8.0: REQ-SRCH-004 多言語並列検索のテスト
+ * @requirement REQ-SRCH-004-01, REQ-SRCH-004-02, REQ-SRCH-004-04
+ */
+
+import { describe, it, expect } from 'vitest';
+import {
+  detectLanguage,
+  translateQuery,
+  normalizeUrl,
+} from '../search.js';
+
+describe('v1.8.0 多言語検索 (REQ-SRCH-004)', () => {
+  describe('detectLanguage (TSK-002)', () => {
+    it('日本語のみのクエリを検出', () => {
+      expect(detectLanguage('ネオジム磁石')).toBe('ja');
+      expect(detectLanguage('自動車業界')).toBe('ja');
+      expect(detectLanguage('プロテリアル 磁石')).toBe('ja');
+    });
+
+    it('英語のみのクエリを検出', () => {
+      expect(detectLanguage('neodymium magnet')).toBe('en');
+      expect(detectLanguage('automotive industry')).toBe('en');
+      expect(detectLanguage('Proterial')).toBe('en');
+    });
+
+    it('混合クエリを検出', () => {
+      expect(detectLanguage('ネオジム magnet')).toBe('mixed');
+      expect(detectLanguage('TDK 磁石')).toBe('mixed');
+      expect(detectLanguage('Proterial ネオジム磁石')).toBe('mixed');
+    });
+  });
+
+  describe('translateQuery (TSK-003)', () => {
+    it('日本語用語を英語に翻訳', () => {
+      const result = translateQuery('ネオジム磁石');
+      expect(result).toBe('neodymium magnet');
+    });
+
+    it('複数用語を翻訳', () => {
+      const result = translateQuery('プロテリアル ネオジム磁石');
+      expect(result).toBe('Proterial neodymium magnet');
+    });
+
+    it('辞書にない語はそのまま', () => {
+      const result = translateQuery('未知の用語');
+      expect(result).toBeNull();  // 変換なし = null
+    });
+
+    it('カスタム辞書で拡張可能', () => {
+      const customDict = { 'カスタム語': 'custom term' };
+      const result = translateQuery('カスタム語', customDict);
+      expect(result).toBe('custom term');
+    });
+
+    it('v1.7.0辞書も使用可能', () => {
+      // BUILTIN_DICTIONARYの用語
+      const result = translateQuery('自動車');
+      expect(result).toBe('automotive');
+    });
+  });
+
+  describe('normalizeUrl (TSK-004)', () => {
+    it('末尾スラッシュを削除', () => {
+      expect(normalizeUrl('https://example.com/page/')).toBe('https://example.com/page');
+    });
+
+    it('トラッキングパラメータを削除', () => {
+      const url = 'https://example.com/page?utm_source=test&id=123';
+      const normalized = normalizeUrl(url);
+      expect(normalized).not.toContain('utm_source');
+      expect(normalized).toContain('id=123');
+    });
+
+    it('大文字を小文字に正規化', () => {
+      expect(normalizeUrl('https://Example.COM/Page')).toBe('https://example.com/page');
+    });
+
+    it('フラグメントを削除', () => {
+      expect(normalizeUrl('https://example.com/page#section')).toBe('https://example.com/page');
+    });
+
+    it('不正なURLはそのまま小文字化', () => {
+      expect(normalizeUrl('invalid-url')).toBe('invalid-url');
+    });
+  });
+});