@fractalizer/mcp-search 0.1.0

package/dist/engine/tool-search-engine.js

@@ -0,0 +1,213 @@
+/**
+ * Главный класс поисковой системы tools
+ *
+ * Responsibilities:
+ * - Выполнение поиска через стратегии
+ * - Фильтрация по категориям и типам
+ * - Кеширование результатов
+ * - Форматирование результатов по уровню детализации
+ * - Lazy loading полных метаданных
+ */
+import { DEFAULT_TOOL_SEARCH_LIMIT, DEFAULT_TOOL_SEARCH_DETAIL_LEVEL } from '../constants.js';
+import { tokenize, getShortDescription } from '../utils/text-utils.js';
+/**
+ * Поисковый движок для tools
+ */
+export class ToolSearchEngine {
+    staticIndex;
+    toolRegistry;
+    searchStrategy;
+    cache;
+    lazyIndex = null;
+    /**
+     * Максимальный размер кеша (LRU)
+     */
+    MAX_CACHE_SIZE = 100;
+    constructor(staticIndex, toolRegistry, searchStrategy) {
+        this.staticIndex = staticIndex;
+        this.toolRegistry = toolRegistry;
+        this.searchStrategy = searchStrategy;
+        this.cache = new Map();
+    }
+    /**
+     * Получить индекс (статический или динамический из ToolRegistry)
+     */
+    getIndex() {
+        // Если есть статический индекс, используем его
+        if (this.staticIndex) {
+            return Array.from(this.staticIndex);
+        }
+        // Иначе генерируем динамический индекс из ToolRegistry (lazy)
+        if (!this.lazyIndex) {
+            this.lazyIndex = this.buildIndexFromRegistry();
+        }
+        return this.lazyIndex;
+    }
+    /**
+     * Построить индекс из ToolRegistry
+     */
+    buildIndexFromRegistry() {
+        const index = [];
+        const tools = this.toolRegistry.getAllTools();
+        for (const tool of tools) {
+            const metadata = tool.getMetadata();
+            const definition = metadata.definition;
+            // Skip tools without required fields
+            // Runtime safety: mock objects in tests may not have all required fields
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            if (!definition.name?.length || !definition.description?.length || !metadata.category?.length) {
+                continue;
+            }
+            index.push({
+                name: definition.name,
+                category: metadata.category,
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Runtime safety: mock objects may not have tags
+                tags: metadata.tags ? Array.from(metadata.tags) : [],
+                isHelper: metadata.isHelper === true,
+                nameTokens: tokenize(definition.name),
+                descriptionTokens: tokenize(definition.description),
+                descriptionShort: getShortDescription(definition.description),
+            });
+        }
+        return index;
+    }
+    /**
+     * Выполнить поиск с кешированием
+     */
+    search(params) {
+        // Генерируем ключ кеша
+        const cacheKey = this.getCacheKey(params);
+        // Проверяем кеш
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Выполняем поиск
+        const results = this.performSearch(params);
+        // Кешируем результат
+        this.cache.set(cacheKey, results);
+        // Ограничиваем размер кеша (простая LRU стратегия)
+        if (this.cache.size > this.MAX_CACHE_SIZE) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+        }
+        return results;
+    }
+    /**
+     * Выполнить поиск без кеширования
+     */
+    performSearch(params) {
+        // Фильтруем индекс (статический или динамический)
+        const filtered = this.filterIndex(params);
+        // Если query пустой или "*", возвращаем все отфильтрованные инструменты
+        let searchResults;
+        if (!params.query || params.query.trim() === '' || params.query === '*') {
+            // Возвращаем все отфильтрованные инструменты (конвертируем в SearchResult)
+            searchResults = filtered.map((tool) => ({
+                toolName: tool.name,
+                score: 1.0, // максимальный score для полного совпадения
+            }));
+        }
+        else {
+            // Выполняем поиск по стратегиям
+            searchResults = this.searchStrategy.search(params.query, filtered);
+        }
+        // Применяем лимит
+        const totalFound = searchResults.length;
+        const limited = searchResults.slice(0, params.limit || DEFAULT_TOOL_SEARCH_LIMIT);
+        // Форматируем результаты
+        const tools = this.formatResults(limited, params.detailLevel || DEFAULT_TOOL_SEARCH_DETAIL_LEVEL);
+        return {
+            tools,
+            totalFound,
+        };
+    }
+    /**
+     * Фильтровать индекс по параметрам
+     */
+    filterIndex(params) {
+        let filtered = this.getIndex();
+        // Фильтр по категории
+        if (params.category) {
+            filtered = filtered.filter((t) => t.category === params.category);
+        }
+        // Фильтр по типу (helper/api)
+        if (params.isHelper !== undefined) {
+            filtered = filtered.filter((t) => t.isHelper === params.isHelper);
+        }
+        return filtered;
+    }
+    /**
+     * Форматировать результаты по уровню детализации
+     */
+    formatResults(results, detailLevel) {
+        const index = this.getIndex();
+        return results.map((r) => {
+            const staticData = index.find((t) => t.name === r.toolName);
+            if (!staticData) {
+                // Не должно произойти, но на всякий случай
+                return { name: r.toolName };
+            }
+            switch (detailLevel) {
+                case 'name_only':
+                    return {
+                        name: staticData.name,
+                    };
+                case 'name_and_description':
+                    return {
+                        name: staticData.name,
+                        description: staticData.descriptionShort,
+                        category: staticData.category,
+                        score: Math.round(r.score * 100) / 100, // 2 decimal places
+                    };
+                case 'full': {
+                    // Lazy load полных метаданных из ToolRegistry
+                    const tool = this.toolRegistry.getTool(staticData.name);
+                    const fullMetadata = tool?.getMetadata();
+                    return {
+                        name: staticData.name,
+                        description: fullMetadata?.definition.description || staticData.descriptionShort,
+                        category: staticData.category,
+                        tags: staticData.tags,
+                        inputSchema: fullMetadata?.definition.inputSchema,
+                        examples: fullMetadata?.examples,
+                        score: Math.round(r.score * 100) / 100,
+                        matchDetails: r.matchDetails,
+                    };
+                }
+            }
+        });
+    }
+    /**
+     * Генерировать ключ кеша из параметров поиска
+     */
+    getCacheKey(params) {
+        return JSON.stringify({
+            q: params.query.toLowerCase().trim(),
+            c: params.category,
+            h: params.isHelper,
+            l: params.limit,
+            d: params.detailLevel || 'name_and_description',
+        });
+    }
+    /**
+     * Очистить кеш
+     *
+     * Полезно для тестов и при обновлении индекса
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Получить статистику кеша
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.MAX_CACHE_SIZE,
+        };
+    }
+}
+//# sourceMappingURL=tool-search-engine.js.map

package/dist/engine/tool-search-engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Модуль поиска tools
+ *
+ * Экспортирует:
+ * - Типы для поиска
+ * - Стратегии поиска
+ * - Поисковый движок
+ * - Веса стратегий
+ */
+export type { StaticToolIndex, SearchResult, SearchParams, SearchResponse, ToolSearchResultItem, StrategyType, DetailLevel, } from './types.js';
+export { STRATEGY_WEIGHTS } from './scoring/strategy-weights.js';
+export type { ISearchStrategy } from './strategies/index.js';
+export { NameSearchStrategy, DescriptionSearchStrategy, CategorySearchStrategy, FuzzySearchStrategy, WeightedCombinedStrategy, } from './strategies/index.js';
+export { ToolSearchEngine } from './engine/tool-search-engine.js';
+export * from './tools/search-tools.tool.js';
+export * from './tools/search-tools.definition.js';
+export * from './tools/search-tools.schema.js';
+export * from './constants.js';
+export { buildIndexFromRegistry } from './utils/build-index-from-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAG/C,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * Модуль поиска tools
+ *
+ * Экспортирует:
+ * - Типы для поиска
+ * - Стратегии поиска
+ * - Поисковый движок
+ * - Веса стратегий
+ */
+// Веса
+export { STRATEGY_WEIGHTS } from './scoring/strategy-weights.js';
+export { NameSearchStrategy, DescriptionSearchStrategy, CategorySearchStrategy, FuzzySearchStrategy, WeightedCombinedStrategy, } from './strategies/index.js';
+// Поисковый движок
+export { ToolSearchEngine } from './engine/tool-search-engine.js';
+// Tools (SearchToolsTool)
+export * from './tools/search-tools.tool.js';
+export * from './tools/search-tools.definition.js';
+export * from './tools/search-tools.schema.js';
+// Constants
+export * from './constants.js';
+// Dynamic index builder
+export { buildIndexFromRegistry } from './utils/build-index-from-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO;AACP,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,0BAA0B;AAC1B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAE/C,YAAY;AACZ,cAAc,gBAAgB,CAAC;AAE/B,wBAAwB;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/scoring/strategy-weights.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Веса стратегий поиска
+ *
+ * Определяют важность каждого типа совпадения в финальном score
+ *
+ * Responsibilities:
+ * - Конфигурация весов для разных типов поиска
+ * - Балансировка между точностью и полнотой
+ */
+import type { StrategyType } from '../types.js';
+/**
+ * Веса стратегий поиска
+ *
+ * Значения (0-1):
+ * - 1.0 - максимальный вес (наиболее релевантно)
+ * - 0.5 - средний вес
+ * - 0.3 - минимальный вес (для дополнительных совпадений)
+ */
+export declare const STRATEGY_WEIGHTS: Record<StrategyType, number>;
+//# sourceMappingURL=strategy-weights.d.ts.map

package/dist/scoring/strategy-weights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-weights.d.ts","sourceRoot":"","sources":["../../src/scoring/strategy-weights.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAoChD,CAAC"}

package/dist/scoring/strategy-weights.js

@@ -0,0 +1,51 @@
+/**
+ * Веса стратегий поиска
+ *
+ * Определяют важность каждого типа совпадения в финальном score
+ *
+ * Responsibilities:
+ * - Конфигурация весов для разных типов поиска
+ * - Балансировка между точностью и полнотой
+ */
+/**
+ * Веса стратегий поиска
+ *
+ * Значения (0-1):
+ * - 1.0 - максимальный вес (наиболее релевантно)
+ * - 0.5 - средний вес
+ * - 0.3 - минимальный вес (для дополнительных совпадений)
+ */
+export const STRATEGY_WEIGHTS = {
+    /**
+     * Совпадение по имени — максимальный приоритет
+     *
+     * Примеры: "get_issues", "ping", "find_issues"
+     */
+    name: 1.0,
+    /**
+     * Совпадение по категории — высокий приоритет
+     *
+     * Примеры: category="issues", category="users"
+     */
+    category: 0.9,
+    /**
+     * Совпадение по тегам — средний приоритет
+     *
+     * Примеры: tags=["batch", "read"], tags=["helper"]
+     */
+    tags: 0.7,
+    /**
+     * Совпадение в описании — низкий приоритет
+     *
+     * Может содержать много noise (общие слова)
+     */
+    description: 0.5,
+    /**
+     * Fuzzy match — минимальный приоритет
+     *
+     * Для опечаток и приблизительных совпадений
+     * Примеры: "get_isseu" → "get_issues"
+     */
+    fuzzy: 0.3,
+};
+//# sourceMappingURL=strategy-weights.js.map

package/dist/scoring/strategy-weights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-weights.js","sourceRoot":"","sources":["../../src/scoring/strategy-weights.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiC;IAC5D;;;;OAIG;IACH,IAAI,EAAE,GAAG;IAET;;;;OAIG;IACH,QAAQ,EAAE,GAAG;IAEb;;;;OAIG;IACH,IAAI,EAAE,GAAG;IAET;;;;OAIG;IACH,WAAW,EAAE,GAAG;IAEhB;;;;;OAKG;IACH,KAAK,EAAE,GAAG;CACF,CAAC"}

package/dist/strategies/category-search.strategy.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Стратегия поиска по категориям и тегам
+ *
+ * Алгоритм:
+ * - Точное совпадение категории: score = 1.0
+ * - Совпадение тега: score = 0.9
+ * - Частичное совпадение тега: score = 0.7
+ *
+ * Responsibilities:
+ * - Поиск по категориям
+ * - Поиск по тегам
+ * - Оценка релевантности совпадения
+ */
+import type { ISearchStrategy } from './search-strategy.interface.js';
+import type { SearchResult, StaticToolIndex } from '../types.js';
+/**
+ * Стратегия поиска по категориям и тегам
+ */
+export declare class CategorySearchStrategy implements ISearchStrategy {
+    search(query: string, tools: StaticToolIndex[]): SearchResult[];
+    /**
+     * Оценка совпадения с категорией
+     */
+    private scoreCategoryMatch;
+    /**
+     * Найти совпадение в тегах
+     */
+    private findTagMatch;
+}
+//# sourceMappingURL=category-search.strategy.d.ts.map

package/dist/strategies/category-search.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-search.strategy.d.ts","sourceRoot":"","sources":["../../src/strategies/category-search.strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE;;GAEG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE;IAqC/D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,YAAY;CAmBrB"}

package/dist/strategies/category-search.strategy.js

@@ -0,0 +1,81 @@
+/**
+ * Стратегия поиска по категориям и тегам
+ *
+ * Алгоритм:
+ * - Точное совпадение категории: score = 1.0
+ * - Совпадение тега: score = 0.9
+ * - Частичное совпадение тега: score = 0.7
+ *
+ * Responsibilities:
+ * - Поиск по категориям
+ * - Поиск по тегам
+ * - Оценка релевантности совпадения
+ */
+/**
+ * Стратегия поиска по категориям и тегам
+ */
+export class CategorySearchStrategy {
+    search(query, tools) {
+        const lowerQuery = query.toLowerCase().trim();
+        if (!lowerQuery) {
+            return [];
+        }
+        const results = [];
+        for (const tool of tools) {
+            // Проверка категории
+            const categoryScore = this.scoreCategoryMatch(tool.category, lowerQuery);
+            if (categoryScore > 0) {
+                results.push({
+                    toolName: tool.name,
+                    score: categoryScore,
+                    matchReason: `Category match: ${tool.category}`,
+                    strategyType: 'category',
+                });
+                continue; // Если нашли в категории, не проверяем теги
+            }
+            // Проверка тегов
+            const tagMatch = this.findTagMatch(tool.tags, lowerQuery);
+            if (tagMatch) {
+                results.push({
+                    toolName: tool.name,
+                    score: tagMatch.score,
+                    matchReason: `Tag match: ${tagMatch.tag}`,
+                    strategyType: 'tags',
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Оценка совпадения с категорией
+     */
+    scoreCategoryMatch(category, query) {
+        const lowerCategory = category.toLowerCase();
+        if (lowerCategory === query) {
+            return 1.0; // Точное совпадение
+        }
+        if (lowerCategory.includes(query) || query.includes(lowerCategory)) {
+            return 0.8; // Частичное совпадение
+        }
+        return 0;
+    }
+    /**
+     * Найти совпадение в тегах
+     */
+    findTagMatch(tags, query) {
+        for (const tag of tags) {
+            const lowerTag = tag.toLowerCase();
+            if (lowerTag === query) {
+                return { tag, score: 0.9 }; // Точное совпадение тега
+            }
+            if (lowerTag.includes(query)) {
+                return { tag, score: 0.7 }; // Частичное совпадение тега
+            }
+            if (query.includes(lowerTag)) {
+                return { tag, score: 0.6 }; // Query содержит тег
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=category-search.strategy.js.map

package/dist/strategies/category-search.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-search.strategy.js","sourceRoot":"","sources":["../../src/strategies/category-search.strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC,MAAM,CAAC,KAAa,EAAE,KAAwB;QAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAE9C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,qBAAqB;YACrB,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACzE,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,KAAK,EAAE,aAAa;oBACpB,WAAW,EAAE,mBAAmB,IAAI,CAAC,QAAQ,EAAE;oBAC/C,YAAY,EAAE,UAAU;iBACzB,CAAC,CAAC;gBACH,SAAS,CAAC,4CAA4C;YACxD,CAAC;YAED,iBAAiB;YACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC1D,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,WAAW,EAAE,cAAc,QAAQ,CAAC,GAAG,EAAE;oBACzC,YAAY,EAAE,MAAM;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,QAAgB,EAAE,KAAa;QACxD,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE7C,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO,GAAG,CAAC,CAAC,oBAAoB;QAClC,CAAC;QAED,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACnE,OAAO,GAAG,CAAC,CAAC,uBAAuB;QACrC,CAAC;QAED,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,IAAc,EAAE,KAAa;QAChD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAEnC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACvB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,yBAAyB;YACvD,CAAC;YAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,4BAA4B;YAC1D,CAAC;YAED,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,qBAAqB;YACnD,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/strategies/description-search.strategy.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Стратегия full-text поиска по описанию
+ *
+ * Алгоритм:
+ * - Токенизация query и description
+ * - Подсчёт совпадающих токенов
+ * - Score = (matched tokens) / (total query tokens) * weight
+ *
+ * Responsibilities:
+ * - Полнотекстовый поиск по описанию
+ * - Токенизация текста
+ * - Оценка релевантности по количеству совпадений
+ */
+import type { ISearchStrategy } from './search-strategy.interface.js';
+import type { SearchResult, StaticToolIndex } from '../types.js';
+/**
+ * Стратегия поиска по описанию
+ */
+export declare class DescriptionSearchStrategy implements ISearchStrategy {
+    /**
+     * Минимальная длина токена для поиска
+     *
+     * Игнорируем короткие слова (предлоги, союзы и т.д.)
+     */
+    private readonly MIN_TOKEN_LENGTH;
+    /**
+     * Вес для description search
+     *
+     * Пониженный, т.к. description может содержать много noise
+     */
+    private readonly DESCRIPTION_WEIGHT;
+    search(query: string, tools: StaticToolIndex[]): SearchResult[];
+    /**
+     * Найти совпадающие токены
+     */
+    private findMatches;
+}
+//# sourceMappingURL=description-search.strategy.d.ts.map

package/dist/strategies/description-search.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-search.strategy.d.ts","sourceRoot":"","sources":["../../src/strategies/description-search.strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGjE;;GAEG;AACH,qBAAa,yBAA0B,YAAW,eAAe;IAC/D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAEtC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IAE1C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE;IA8B/D;;OAEG;IACH,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/strategies/description-search.strategy.js

@@ -0,0 +1,68 @@
+/**
+ * Стратегия full-text поиска по описанию
+ *
+ * Алгоритм:
+ * - Токенизация query и description
+ * - Подсчёт совпадающих токенов
+ * - Score = (matched tokens) / (total query tokens) * weight
+ *
+ * Responsibilities:
+ * - Полнотекстовый поиск по описанию
+ * - Токенизация текста
+ * - Оценка релевантности по количеству совпадений
+ */
+import { tokenize } from '../utils/text-utils.js';
+/**
+ * Стратегия поиска по описанию
+ */
+export class DescriptionSearchStrategy {
+    /**
+     * Минимальная длина токена для поиска
+     *
+     * Игнорируем короткие слова (предлоги, союзы и т.д.)
+     */
+    MIN_TOKEN_LENGTH = 2;
+    /**
+     * Вес для description search
+     *
+     * Пониженный, т.к. description может содержать много noise
+     */
+    DESCRIPTION_WEIGHT = 0.7;
+    search(query, tools) {
+        const queryTokens = tokenize(query, {
+            normalizeSeparators: false,
+            minLength: this.MIN_TOKEN_LENGTH,
+        });
+        if (queryTokens.length === 0) {
+            return [];
+        }
+        const results = [];
+        for (const tool of tools) {
+            const matches = this.findMatches(queryTokens, tool.descriptionTokens);
+            if (matches.length > 0) {
+                const score = (matches.length / queryTokens.length) * this.DESCRIPTION_WEIGHT;
+                results.push({
+                    toolName: tool.name,
+                    score,
+                    matchReason: `Matched ${matches.length}/${queryTokens.length} tokens in description`,
+                    strategyType: 'description',
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Найти совпадающие токены
+     */
+    findMatches(queryTokens, descTokens) {
+        const matches = [];
+        for (const queryToken of queryTokens) {
+            const found = descTokens.some((descToken) => descToken.includes(queryToken) || queryToken.includes(descToken));
+            if (found) {
+                matches.push(queryToken);
+            }
+        }
+        return matches;
+    }
+}
+//# sourceMappingURL=description-search.strategy.js.map

package/dist/strategies/description-search.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-search.strategy.js","sourceRoot":"","sources":["../../src/strategies/description-search.strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;OAIG;IACc,gBAAgB,GAAG,CAAC,CAAC;IAEtC;;;;OAIG;IACc,kBAAkB,GAAG,GAAG,CAAC;IAE1C,MAAM,CAAC,KAAa,EAAE,KAAwB;QAC5C,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE;YAClC,mBAAmB,EAAE,KAAK;YAC1B,SAAS,EAAE,IAAI,CAAC,gBAAgB;SACjC,CAAC,CAAC;QAEH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAEtE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC;gBAE9E,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,KAAK;oBACL,WAAW,EAAE,WAAW,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,wBAAwB;oBACpF,YAAY,EAAE,aAAa;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,WAAqB,EAAE,UAAoB;QAC7D,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAC3B,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAChF,CAAC;YAEF,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CAEF"}

package/dist/strategies/fuzzy-search.strategy.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Стратегия fuzzy поиска с использованием Levenshtein distance
+ *
+ * Алгоритм:
+ * - Вычисление Levenshtein distance между query и именем
+ * - Score уменьшается с ростом distance
+ * - Поиск в имени и токенах
+ *
+ * Полезно для:
+ * - Опечатки (get_isseu → get_issues)
+ * - Частичные совпадения (get_iss → get_issues)
+ *
+ * Responsibilities:
+ * - Fuzzy matching с допустимой погрешностью
+ * - Вычисление Levenshtein distance
+ * - Оценка релевантности с учётом distance
+ */
+import type { ISearchStrategy } from './search-strategy.interface.js';
+import type { SearchResult, StaticToolIndex } from '../types.js';
+/**
+ * Стратегия fuzzy поиска
+ */
+export declare class FuzzySearchStrategy implements ISearchStrategy {
+    /**
+     * Максимальная допустимая distance
+     *
+     * distance = количество операций (insert/delete/replace)
+     * для преобразования одной строки в другую
+     */
+    private readonly maxDistance;
+    /**
+     * Вес для token matches
+     *
+     * Поиск в токенах менее точен, чем в полном имени
+     */
+    private readonly TOKEN_WEIGHT;
+    constructor(maxDistance?: number);
+    search(query: string, tools: StaticToolIndex[]): SearchResult[];
+    /**
+     * Найти fuzzy match в токенах
+     */
+    private findTokenMatch;
+    /**
+     * Вычислить score на основе distance
+     *
+     * Score уменьшается линейно с ростом distance:
+     * - distance = 0 → score = 1.0
+     * - distance = maxDistance → score ≈ 0
+     */
+    private calculateScore;
+    /**
+     * Levenshtein distance algorithm
+     *
+     * Вычисляет минимальное количество операций (insert/delete/replace)
+     * для преобразования одной строки в другую
+     *
+     * Complexity: O(m * n), где m и n - длины строк
+     *
+     * @param a - первая строка
+     * @param b - вторая строка
+     * @returns количество операций редактирования
+     */
+    private levenshteinDistance;
+}
+//# sourceMappingURL=fuzzy-search.strategy.d.ts.map