skill-creator 0.0.0 → 1.0.0

package/dist/core/fuzzySearch.js

@@ -0,0 +1,271 @@
+import uFuzzy from '@leeoniya/ufuzzy';
+import { glob } from 'glob';
+import { readFileSync } from 'node:fs';
+export class FuzzySearchEngine {
+    options;
+    documents = [];
+    constructor(options = {}) {
+        this.options = {
+            fuzzyThreshold: 0.5,
+            prioritizeExact: true,
+            maxResults: 20,
+            ...options,
+        };
+    }
+    /**
+     * Enhanced fuzzy search function that returns both indices and detailed info
+     */
+    fuzzySearchWithInfo(haystack, needle) {
+        if (!needle || needle.length < 1)
+            return { indices: [], info: null };
+        if (!haystack || haystack.length === 0)
+            return { indices: [], info: null };
+        const fuzzy = new uFuzzy({ unicode: true });
+        const idxs = fuzzy.filter(haystack, needle);
+        if (!idxs || idxs.length === 0) {
+            return { indices: [], info: null };
+        }
+        const info = fuzzy.info(idxs, haystack, needle);
+        const order = fuzzy.sort(info, haystack, needle);
+        const indices = order.map((sortedIdx) => {
+            return info.idx[sortedIdx];
+        });
+        return { indices, info };
+    }
+    async buildIndex(referencesDir, hashFile) {
+        console.log('Building enhanced fuzzy search index with uFuzzy...');
+        // Get all markdown files
+        const files = await glob('**/*.md', { cwd: referencesDir });
+        if (files.length === 0) {
+            console.log('No documentation files found to index');
+            return;
+        }
+        this.documents = [];
+        for (const filePath of files) {
+            try {
+                const fullPath = `${referencesDir}/${filePath}`;
+                const content = readFileSync(fullPath, 'utf-8');
+                // Extract title from first line or filename
+                const lines = content.split('\n');
+                const title = lines[0]?.replace(/^#+\s*/, '').trim() ||
+                    filePath.replace(/\.md$/, '').replace(/[-_]/g, ' ');
+                // Determine source based on path
+                const source = filePath.includes('context7/') ? 'context7' : 'user';
+                const document = {
+                    id: filePath,
+                    title: title,
+                    content: content,
+                    source: source,
+                    file_path: fullPath,
+                    metadata: {
+                        file_name: filePath,
+                        file_path: fullPath,
+                    },
+                };
+                this.documents.push(document);
+            }
+            catch (error) {
+                console.warn(`Failed to process file ${filePath}:`, error);
+            }
+        }
+        console.log(`✅ Enhanced fuzzy search index built with ${this.documents.length} documents`);
+    }
+    async search(query, topK = 5, where) {
+        // Helper function to safely convert to string
+        const safeString = (value) => {
+            if (value === null || value === undefined)
+                return '';
+            if (typeof value === 'string') {
+                // Filter out empty strings and very short strings
+                return value.trim().length >= 2 ? value.trim() : '';
+            }
+            if (typeof value === 'number' || typeof value === 'boolean')
+                return String(value);
+            return '';
+        };
+        // Sanitize the query
+        const sanitizedQuery = safeString(query);
+        if (sanitizedQuery.length < 1) {
+            console.warn('Query too short or invalid for fuzzy search');
+            return [];
+        }
+        if (this.documents.length === 0) {
+            console.warn('Search index not built. Call buildIndex() first.');
+            return [];
+        }
+        // Filter documents by source if specified
+        let filteredDocs = this.documents;
+        if (where?.source) {
+            filteredDocs = this.documents.filter((doc) => doc.source === where.source);
+        }
+        // If no documents match the filter, return empty
+        if (filteredDocs.length === 0) {
+            return [];
+        }
+        const candidates = [];
+        // Prepare search arrays
+        const titles = filteredDocs.map((doc) => safeString(doc.title)).filter((t) => t.length >= 2);
+        const contents = filteredDocs.map((doc) => safeString(doc.content)).filter((c) => c.length >= 2);
+        const fileNames = filteredDocs
+            .map((doc) => safeString(doc.metadata.file_name))
+            .filter((f) => f.length >= 2);
+        // Search in titles (highest priority)
+        const titleResult = this.fuzzySearchWithInfo(titles, sanitizedQuery);
+        titleResult.indices.forEach((idx, i) => {
+            const doc = filteredDocs[idx];
+            if (doc) {
+                candidates.push({
+                    doc,
+                    score: this.calculateFuzzyScore(titleResult.info, i),
+                    matchType: 'title',
+                    info: titleResult.info,
+                    ranges: titleResult.info?.ranges,
+                });
+            }
+        });
+        // Search in content (medium priority)
+        const contentResult = this.fuzzySearchWithInfo(contents, sanitizedQuery);
+        contentResult.indices.forEach((idx, i) => {
+            const doc = filteredDocs[idx];
+            if (doc && !candidates.find((c) => c.doc.id === doc.id)) {
+                candidates.push({
+                    doc,
+                    score: this.calculateFuzzyScore(contentResult.info, i) * 0.7, // Reduce score for content matches
+                    matchType: 'content',
+                    info: contentResult.info,
+                    ranges: contentResult.info?.ranges,
+                });
+            }
+        });
+        // Search in file names (lowest priority)
+        const fileNameResult = this.fuzzySearchWithInfo(fileNames, sanitizedQuery);
+        fileNameResult.indices.forEach((idx, i) => {
+            const doc = filteredDocs[idx];
+            if (doc && !candidates.find((c) => c.doc.id === doc.id)) {
+                candidates.push({
+                    doc,
+                    score: this.calculateFuzzyScore(fileNameResult.info, i) * 0.5, // Reduce score for filename matches
+                    matchType: 'filename',
+                    info: fileNameResult.info,
+                    ranges: fileNameResult.info?.ranges,
+                });
+            }
+        });
+        // Sort by score and convert to SearchResult
+        const sortedCandidates = candidates.sort((a, b) => b.score - a.score).slice(0, topK);
+        const maxScore = sortedCandidates.length > 0 ? sortedCandidates[0].score : 0;
+        const averageScore = sortedCandidates.reduce((sum, c) => sum + c.score, 0) / sortedCandidates.length || 0;
+        return sortedCandidates.map((candidate) => {
+            const { doc, score, matchType } = candidate;
+            // Add enhanced metadata for smart content handling
+            const enhancedMetadata = {
+                ...doc.metadata,
+                matchType,
+                originalScore: score,
+                maxScore,
+                averageScore,
+            };
+            return {
+                id: doc.id,
+                title: doc.title,
+                content: this.selectContent(doc.content, score, maxScore, averageScore, candidate.info?.ranges),
+                source: doc.source,
+                file_path: doc.file_path,
+                score,
+                metadata: enhancedMetadata,
+            };
+        });
+    }
+    /**
+     * Calculate fuzzy search score based on uFuzzy info
+     */
+    calculateFuzzyScore(info, resultIndex) {
+        if (!info)
+            return 0;
+        const { chars, terms, interIns, intraIns } = info;
+        // Base score: exact match ratio
+        const exactRatio = (chars[resultIndex] || 0) / (terms[resultIndex] || 1);
+        // Penalty for insertions
+        const insertionPenalty = (interIns[resultIndex] + intraIns[resultIndex]) * 0.1;
+        // Final score (0-1)
+        return Math.max(0, Math.min(1, exactRatio - insertionPenalty));
+    }
+    /**
+     * Smart content selection based on score
+     */
+    selectContent(content, score, maxScore, averageScore, ranges) {
+        const showFullContentThreshold = 0.8;
+        const minScoreForPreview = 0.3;
+        if (score >= maxScore * showFullContentThreshold) {
+            // High score: return full content
+            return content;
+        }
+        else if (score >= averageScore * minScoreForPreview) {
+            // Medium score: return range-based preview
+            return this.extractRangePreview(content, ranges);
+        }
+        // Low score: return standard preview
+        return content.substring(0, 200) + '...';
+    }
+    /**
+     * Extract preview based on match ranges
+     */
+    extractRangePreview(content, ranges) {
+        if (!ranges || ranges.length === 0) {
+            return content.substring(0, 100) + '...';
+        }
+        const lines = content.split('\n');
+        const previewLines = [];
+        // Extract lines around match ranges
+        ranges.forEach(([start, ...end]) => {
+            const startLine = Math.floor(start / 50); // Rough estimate of line numbers
+            const endLine = Math.floor(end[end.length - 1] / 50);
+            for (let i = Math.max(0, startLine - 1); i <= Math.min(lines.length - 1, endLine + 1); i++) {
+                if (!previewLines.includes(lines[i])) {
+                    previewLines.push(lines[i]);
+                }
+            }
+        });
+        return previewLines.slice(0, 5).join('\n') + (previewLines.length > 5 ? '\n...' : '');
+    }
+    async searchByPriority(query, topK = 5) {
+        // Search with priority on user documents first
+        const userResults = await this.search(query, Math.ceil(topK / 2), { source: 'user' });
+        const context7Results = await this.search(query, Math.ceil(topK / 2), { source: 'context7' });
+        // Combine and sort by score
+        const allResults = [...userResults, ...context7Results]
+            .sort((a, b) => {
+            // User documents get priority boost
+            const aBoost = a.source === 'user' ? 0.2 : 0;
+            const bBoost = b.source === 'user' ? 0.2 : 0;
+            return b.score + bBoost - (a.score + aBoost);
+        })
+            .slice(0, topK);
+        return allResults;
+    }
+    /**
+     * Get statistics about the search index
+     */
+    getStats() {
+        const userDocs = this.documents.filter((doc) => doc.source === 'user');
+        const context7Docs = this.documents.filter((doc) => doc.source === 'context7');
+        return {
+            totalDocuments: this.documents.length,
+            userDocuments: userDocs.length,
+            context7Documents: context7Docs.length,
+        };
+    }
+    /**
+     * Check if the search index is built
+     */
+    isBuilt() {
+        return this.documents.length > 0;
+    }
+    /**
+     * Clear the search index
+     */
+    clearIndex() {
+        this.documents = [];
+    }
+}
+//# sourceMappingURL=fuzzySearch.js.map

package/dist/core/fuzzySearch.js.map

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

package/dist/core/fuzzySearchAdapter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Fuzzy Search Engine Adapter
+ * Implements the SearchEngine interface using uFuzzy library
+ * Clean, focused implementation - formatting handled by separate formatters
+ */
+import type { SearchEngine, SearchResult, SearchOptions } from './searchAdapter';
+/**
+ * uFuzzy-based Search Engine Adapter
+ * Clean implementation focused only on search functionality
+ */
+export declare class FuzzySearchAdapter implements SearchEngine {
+    private documents;
+    private fuzzy;
+    private lastSearchInfo;
+    constructor();
+    buildIndex(referencesDir: string): Promise<void>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Basic fuzzy search using uFuzzy
+     */
+    private fuzzySearch;
+    /**
+     * Enhanced fuzzy search that returns both indices and detailed info
+     */
+    private fuzzySearchWithInfo;
+    isBuilt(): boolean;
+    getStats(): Promise<{
+        totalDocuments: number;
+    }>;
+    searchByPriority(query: string, topK?: number): Promise<SearchResult[]>;
+    clearIndex(): void;
+}
+//# sourceMappingURL=fuzzySearchAdapter.d.ts.map

package/dist/core/fuzzySearchAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzySearchAdapter.d.ts","sourceRoot":"","sources":["../../src/core/fuzzySearchAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAKhF;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,SAAS,CAOV;IAEP,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,cAAc,CAA8B;;IAS9C,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ChD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA6FjF;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,IAAI,OAAO;IAIZ,QAAQ,IAAI,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKhF,UAAU,IAAI,IAAI;CAInB"}

package/dist/core/fuzzySearchAdapter.js

@@ -0,0 +1,185 @@
+/**
+ * Fuzzy Search Engine Adapter
+ * Implements the SearchEngine interface using uFuzzy library
+ * Clean, focused implementation - formatting handled by separate formatters
+ */
+import uFuzzy from '@leeoniya/ufuzzy';
+import { glob } from 'glob';
+import { readFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+/**
+ * uFuzzy-based Search Engine Adapter
+ * Clean implementation focused only on search functionality
+ */
+export class FuzzySearchAdapter {
+    documents = [];
+    fuzzy;
+    lastSearchInfo = new Map();
+    constructor() {
+        // Initialize uFuzzy with sensible defaults
+        this.fuzzy = new uFuzzy({
+            unicode: true,
+        });
+    }
+    async buildIndex(referencesDir) {
+        console.log('🔨 Building fuzzy search index with uFuzzy...');
+        const files = await glob('**/*.md', { cwd: referencesDir });
+        if (files.length === 0) {
+            console.log('No documentation files found to index');
+            return;
+        }
+        this.documents = [];
+        for (const filePath of files) {
+            try {
+                const fullPath = join(referencesDir, filePath);
+                const content = readFileSync(fullPath, 'utf-8');
+                // Extract title from first line or filename
+                const lines = content.split('\n');
+                const title = lines[0]?.replace(/^#+\s*/, '').trim() || basename(filePath, '.md').replace(/[-_]/g, ' ');
+                const source = filePath.includes('context7/') ? 'context7' : 'user';
+                this.documents.push({
+                    id: filePath,
+                    title,
+                    content,
+                    source,
+                    file_path: fullPath,
+                    metadata: {
+                        file_name: basename(filePath),
+                        file_path: filePath,
+                    },
+                });
+            }
+            catch (error) {
+                console.warn(`Warning: Failed to index file ${filePath}:`, error);
+            }
+        }
+        console.log(`✅ Fuzzy search index built with ${this.documents.length} documents`);
+    }
+    async search(query, options = {}) {
+        const { topK = 5, where } = options;
+        if (this.documents.length === 0) {
+            console.warn('Search index not built. Call buildIndex() first.');
+            return [];
+        }
+        // Filter documents by source if specified
+        let searchableDocs = this.documents;
+        if (where?.source) {
+            searchableDocs = this.documents.filter((doc) => doc.source === where.source);
+        }
+        if (searchableDocs.length === 0) {
+            return [];
+        }
+        const results = [];
+        const seenIds = new Set();
+        // Prepare search arrays
+        const titles = searchableDocs.map((doc) => doc.title);
+        const contents = searchableDocs.map((doc) => doc.content);
+        const fileNames = searchableDocs.map((doc) => doc.metadata.file_name);
+        // Search in titles (highest priority - score 1.0)
+        const titleMatches = this.fuzzySearch(titles, query);
+        titleMatches.forEach((idx) => {
+            const doc = searchableDocs[idx];
+            if (doc && !seenIds.has(doc.id)) {
+                seenIds.add(doc.id);
+                results.push({
+                    id: doc.id,
+                    title: doc.title,
+                    content: doc.content,
+                    source: doc.source,
+                    file_path: doc.file_path,
+                    score: 1.0,
+                    metadata: {
+                        ...doc.metadata,
+                        matchType: 'title',
+                    },
+                });
+            }
+        });
+        // Search in content (medium priority - score 0.7)
+        const contentMatches = this.fuzzySearch(contents, query);
+        contentMatches.forEach((idx) => {
+            const doc = searchableDocs[idx];
+            if (doc && !seenIds.has(doc.id)) {
+                seenIds.add(doc.id);
+                results.push({
+                    id: doc.id,
+                    title: doc.title,
+                    content: doc.content,
+                    source: doc.source,
+                    file_path: doc.file_path,
+                    score: 0.7,
+                    metadata: {
+                        ...doc.metadata,
+                        matchType: 'content',
+                    },
+                });
+            }
+        });
+        // Search in file names (lowest priority - score 0.5)
+        const fileNameMatches = this.fuzzySearch(fileNames, query);
+        fileNameMatches.forEach((idx) => {
+            const doc = searchableDocs[idx];
+            if (doc && !seenIds.has(doc.id)) {
+                seenIds.add(doc.id);
+                results.push({
+                    id: doc.id,
+                    title: doc.title,
+                    content: doc.content,
+                    source: doc.source,
+                    file_path: doc.file_path,
+                    score: 0.5,
+                    metadata: {
+                        ...doc.metadata,
+                        matchType: 'filename',
+                    },
+                });
+            }
+        });
+        // Sort by score and limit to topK
+        return results.sort((a, b) => b.score - a.score).slice(0, topK);
+    }
+    /**
+     * Basic fuzzy search using uFuzzy
+     */
+    fuzzySearch(haystack, needle) {
+        const result = this.fuzzySearchWithInfo(haystack, needle);
+        return result.indices;
+    }
+    /**
+     * Enhanced fuzzy search that returns both indices and detailed info
+     */
+    fuzzySearchWithInfo(haystack, needle) {
+        if (!needle || needle.length < 1)
+            return { indices: [], info: null };
+        if (!haystack || haystack.length === 0)
+            return { indices: [], info: null };
+        const idxs = this.fuzzy.filter(haystack, needle);
+        if (!idxs || idxs.length === 0) {
+            return { indices: [], info: null };
+        }
+        const info = this.fuzzy.info(idxs, haystack, needle);
+        const order = this.fuzzy.sort(info, haystack, needle);
+        // Store info for later use
+        const searchKey = `${needle}-${JSON.stringify(haystack.slice(0, 3))}`;
+        this.lastSearchInfo.set(searchKey, info);
+        const indices = order.map((sortedIdx) => {
+            return info.idx[sortedIdx];
+        });
+        return { indices, info };
+    }
+    isBuilt() {
+        return this.documents.length > 0;
+    }
+    async getStats() {
+        return { totalDocuments: this.documents.length };
+    }
+    async searchByPriority(query, topK = 5) {
+        // For fuzzy search, this is the same as regular search
+        return this.search(query, { topK });
+    }
+    clearIndex() {
+        this.documents = [];
+        this.lastSearchInfo.clear();
+    }
+}
+//# sourceMappingURL=fuzzySearchAdapter.js.map

package/dist/core/fuzzySearchAdapter.js.map

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

package/dist/core/portUtils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 端口管理工具
+ * 用于动态分配和管理 ChromaDB 服务器端口
+ */
+/**
+ * 查找可用的端口
+ * @param startPort 起始端口号
+ * @param maxPort 最大端口号
+ * @returns 可用的端口号
+ */
+export declare function findAvailablePort(): Promise<number>;
+/**
+ * 检查端口是否可用
+ * @param port 端口号
+ * @returns 端口是否可用
+ */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+/**
+ * 等待端口上的服务启动
+ * @param port 端口号
+ * @param timeout 超时时间（毫秒）
+ * @returns 服务是否成功启动
+ */
+export declare function waitForService(port: number, timeout?: number): Promise<boolean>;
+/**
+ * 端口管理器类
+ */
+export declare class PortManager {
+    private usedPorts;
+    private basePort;
+    constructor(basePort?: number);
+    /**
+     * 分配一个可用端口
+     * @returns 分配的端口号
+     */
+    allocatePort(): Promise<number>;
+    /**
+     * 释放端口
+     * @param port 要释放的端口号
+     */
+    releasePort(port: number): void;
+    /**
+     * 获取当前已使用的端口数量
+     */
+    getUsedPortCount(): number;
+    /**
+     * 清理所有端口
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=portUtils.d.ts.map

package/dist/core/portUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portUtils.d.ts","sourceRoot":"","sources":["../../src/core/portUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAezD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAepE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAgC5F;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,QAAQ,GAAE,MAAa;IAInC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAYrC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}