mcmodding-mcp 0.1.0

package/dist/services/example-service.js

@@ -0,0 +1,302 @@
+import { DocumentStore } from '../indexer/store.js';
+import { tokenizeQuery, calculateRelevanceScore, deduplicateAndRank, } from './search-utils.js';
+import path from 'path';
+export class ExampleService {
+    store;
+    constructor(dbPath) {
+        const finalPath = dbPath || process.env.DB_PATH || path.join(process.cwd(), 'data', 'mcmodding-docs.db');
+        console.error(`[ExampleService] Using database at: ${finalPath}`);
+        this.store = new DocumentStore(finalPath);
+    }
+    getExamples(options) {
+        const { topic, language, minecraftVersion, loader, category, limit = 5 } = options;
+        console.error(`[ExampleService] Searching for: "${topic}"`);
+        const query = tokenizeQuery(topic);
+        console.error(`[ExampleService] Tokens: ${query.tokens.join(', ')}`);
+        console.error(`[ExampleService] Expanded: ${query.expandedTokens.slice(0, 10).join(', ')}...`);
+        console.error(`[ExampleService] FTS Query: ${query.ftsQuery}`);
+        const allResults = [];
+        const chunkResults = this.searchViaChunks(query, {
+            language,
+            minecraftVersion,
+            loader,
+            category,
+        });
+        allResults.push(...chunkResults);
+        console.error(`[ExampleService] Strategy 1 (chunks): ${chunkResults.length} results`);
+        if (query.codePatterns.length > 0) {
+            const codeResults = this.searchViaCodePatterns(query, {
+                language,
+                minecraftVersion,
+                loader,
+            });
+            allResults.push(...codeResults);
+            console.error(`[ExampleService] Strategy 2 (code patterns): ${codeResults.length} results`);
+        }
+        const docResults = this.searchViaDocuments(query, {
+            language,
+            minecraftVersion,
+            loader,
+            category,
+        });
+        allResults.push(...docResults);
+        console.error(`[ExampleService] Strategy 3 (documents): ${docResults.length} results`);
+        if (allResults.length < limit) {
+            const fallbackResults = this.fallbackSearch(query, {
+                language,
+                minecraftVersion,
+                loader,
+                limit: limit * 3,
+            });
+            allResults.push(...fallbackResults);
+            console.error(`[ExampleService] Strategy 4 (fallback): ${fallbackResults.length} results`);
+        }
+        const ranked = deduplicateAndRank(allResults, limit);
+        console.error(`[ExampleService] After dedup/rank: ${ranked.length} results`);
+        const examples = ranked.map((r) => this.toCodeExample(r.item, r.score, r.matchReasons));
+        return examples;
+    }
+    getLatestMinecraftVersion() {
+        const versions = this.store.getAllVersions().sort((a, b) => {
+            const aParts = a.split('.').map(Number);
+            const bParts = b.split('.').map(Number);
+            for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+                const aNum = aParts[i] || 0;
+                const bNum = bParts[i] || 0;
+                if (aNum !== bNum) {
+                    return bNum - aNum;
+                }
+            }
+            return 0;
+        });
+        console.error(`[ExampleService] Available versions: ${versions.join(', ')}`);
+        if (versions.length === 0) {
+            return '1.21.4';
+        }
+        return versions[0] || '1.21.4';
+    }
+    searchViaChunks(query, options) {
+        const results = [];
+        const chunks = this.store.searchChunksAdvanced(query.ftsQuery, query.likePatterns, {
+            hasCode: true,
+            language: options.language,
+            loader: options.loader,
+            minecraftVersion: options.minecraftVersion,
+            category: options.category,
+            limit: 30,
+        });
+        const seenDocIds = new Set();
+        for (const chunk of chunks) {
+            if (seenDocIds.has(chunk.document_id))
+                continue;
+            seenDocIds.add(chunk.document_id);
+            const codeBlocks = this.store.getCodeBlocksWithContext(chunk.document_id);
+            for (const block of codeBlocks) {
+                if (options.language && block.language !== options.language)
+                    continue;
+                const { score, reasons } = calculateRelevanceScore({
+                    title: block.document_title,
+                    section_heading: block.section_heading,
+                    section_content: block.section_content,
+                    code: block.code,
+                    caption: block.caption,
+                    category: block.category,
+                    url: block.document_url,
+                }, query);
+                if (score > 0) {
+                    results.push({
+                        item: block,
+                        score,
+                        matchReasons: reasons,
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    searchViaCodePatterns(query, options) {
+        const results = [];
+        const codeBlocks = this.store.searchCodeBlocksByPatterns(query.codePatterns, {
+            language: options.language,
+            loader: options.loader,
+            minecraftVersion: options.minecraftVersion,
+            limit: 30,
+        });
+        for (const block of codeBlocks) {
+            const { score, reasons } = calculateRelevanceScore({
+                title: block.document_title,
+                section_heading: block.section_heading,
+                section_content: block.section_content,
+                code: block.code,
+                caption: block.caption,
+                category: block.category,
+                url: block.document_url,
+            }, query);
+            const boostedScore = score + 30;
+            results.push({
+                item: block,
+                score: boostedScore,
+                matchReasons: [...reasons, 'code pattern match'],
+            });
+        }
+        return results;
+    }
+    searchViaDocuments(query, options) {
+        const results = [];
+        const docs = this.store.searchDocumentsLike(query.likePatterns, {
+            loader: options.loader,
+            minecraftVersion: options.minecraftVersion,
+            category: options.category,
+            limit: 15,
+        });
+        for (const doc of docs) {
+            const codeBlocks = this.store.getCodeBlocksWithContext(doc.id);
+            for (const block of codeBlocks) {
+                if (options.language && block.language !== options.language)
+                    continue;
+                const { score, reasons } = calculateRelevanceScore({
+                    title: block.document_title,
+                    section_heading: block.section_heading,
+                    section_content: block.section_content,
+                    code: block.code,
+                    caption: block.caption,
+                    category: block.category,
+                    url: block.document_url,
+                }, query);
+                if (score > 0) {
+                    results.push({
+                        item: block,
+                        score,
+                        matchReasons: reasons,
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    fallbackSearch(query, options) {
+        const results = [];
+        const codeBlocks = this.store.getAllCodeBlocksWithContext({
+            language: options.language,
+            loader: options.loader,
+            minecraftVersion: options.minecraftVersion,
+            limit: options.limit || 100,
+        });
+        for (const block of codeBlocks) {
+            const { score, reasons } = calculateRelevanceScore({
+                title: block.document_title,
+                section_heading: block.section_heading,
+                section_content: block.section_content,
+                code: block.code,
+                caption: block.caption,
+                category: block.category,
+                url: block.document_url,
+            }, query);
+            if (score >= 10) {
+                results.push({
+                    item: block,
+                    score,
+                    matchReasons: reasons,
+                });
+            }
+        }
+        return results;
+    }
+    toCodeExample(block, score, matchReasons) {
+        return {
+            code: block.code,
+            language: block.language,
+            description: this.generateDescription(block),
+            relevanceScore: score,
+            matchReasons,
+            context: {
+                sectionHeading: block.section_heading,
+                sectionContent: this.truncateContent(block.section_content, 500),
+                documentTitle: block.document_title,
+                documentUrl: block.document_url,
+                category: block.category,
+            },
+            metadata: {
+                loader: block.loader,
+                minecraftVersion: block.minecraft_version,
+                caption: block.caption || undefined,
+            },
+        };
+    }
+    generateDescription(block) {
+        if (block.caption) {
+            return block.caption;
+        }
+        const sentences = block.section_content.split(/[.!?]+/);
+        if (sentences.length > 0 && sentences[0] && sentences[0].trim().length > 10) {
+            const firstSentence = sentences[0].trim();
+            if (firstSentence.length <= 200) {
+                return firstSentence;
+            }
+            return firstSentence.substring(0, 197) + '...';
+        }
+        return `Code example from "${block.section_heading}" in ${block.document_title}`;
+    }
+    truncateContent(content, maxLength) {
+        if (content.length <= maxLength) {
+            return content;
+        }
+        const truncated = content.substring(0, maxLength);
+        const lastPeriod = truncated.lastIndexOf('.');
+        const lastQuestion = truncated.lastIndexOf('?');
+        const lastExclamation = truncated.lastIndexOf('!');
+        const lastSentenceEnd = Math.max(lastPeriod, lastQuestion, lastExclamation);
+        if (lastSentenceEnd > maxLength * 0.7) {
+            return truncated.substring(0, lastSentenceEnd + 1);
+        }
+        const lastSpace = truncated.lastIndexOf(' ');
+        if (lastSpace > maxLength * 0.8) {
+            return truncated.substring(0, lastSpace) + '...';
+        }
+        return truncated + '...';
+    }
+    getAvailableTopics() {
+        const stats = this.store.getStats();
+        const languages = this.store.getAvailableLanguages();
+        const versions = this.store.getAllVersions();
+        return {
+            categories: Object.keys(stats.loaders),
+            languages,
+            loaders: ['fabric', 'neoforge', 'shared'],
+            versions,
+        };
+    }
+    formatForAI(examples) {
+        if (examples.length === 0) {
+            return 'No code examples found for the specified criteria.';
+        }
+        let output = `Found ${examples.length} relevant code example${examples.length > 1 ? 's' : ''} for minecraft version ${examples[0]?.metadata.minecraftVersion || 'unknown'}:\n\n`;
+        for (let i = 0; i < examples.length; i++) {
+            const example = examples[i];
+            if (!example)
+                continue;
+            output += `## Example ${i + 1}: ${example.context.sectionHeading}\n\n`;
+            if (example.description) {
+                output += `**Description:** ${example.description}\n\n`;
+            }
+            output += `**Source:** ${example.context.documentTitle}\n`;
+            output += `**Category:** ${example.context.category}\n`;
+            output += `**Loader:** ${example.metadata.loader}\n`;
+            if (example.metadata.minecraftVersion) {
+                output += `**Minecraft Version:** ${example.metadata.minecraftVersion}\n`;
+            }
+            output += `**URL:** ${example.context.documentUrl}\n`;
+            output += `**Relevance:** ${example.relevanceScore} (${example.matchReasons.slice(0, 3).join(', ')})\n\n`;
+            output += `\`\`\`${example.language}\n${example.code}\n\`\`\`\n\n`;
+            if (example.context.sectionContent && example.context.sectionContent.length > 50) {
+                output += `**Context:**\n${example.context.sectionContent}\n\n`;
+            }
+            output += '---\n\n';
+        }
+        return output;
+    }
+    close() {
+        this.store.close();
+    }
+}
+//# sourceMappingURL=example-service.js.map

package/dist/services/example-service.js.map

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

package/dist/services/search-service.d.ts

@@ -0,0 +1,54 @@
+export interface SearchResult {
+    title: string;
+    url: string;
+    category: string;
+    loader: string;
+    minecraftVersion: string | null;
+    relevanceScore: number;
+    matchReasons: string[];
+    snippet: string;
+    sections: Array<{
+        heading: string;
+        content: string;
+        hasCode: boolean;
+    }>;
+}
+export interface SearchOptions {
+    query: string;
+    category?: string;
+    loader?: string;
+    minecraftVersion?: string;
+    includeCode?: boolean;
+    limit?: number;
+}
+export declare class SearchService {
+    private store;
+    private embeddingGenerator;
+    constructor(dbPath?: string);
+    search(options: SearchOptions): Promise<SearchResult[]>;
+    private getVersionFilter;
+    private searchViaEmbeddings;
+    private extractVersionFromQuery;
+    private applyVersionBoost;
+    private deduplicateByUrlPath;
+    private isSameMinorVersion;
+    private compareVersions;
+    private searchViaChunks;
+    private searchViaDocuments;
+    private searchViaSections;
+    private toSearchResult;
+    private cleanContent;
+    private getSectionsForDocument;
+    private generateSnippet;
+    private truncateCodeAware;
+    getStats(): {
+        totalDocuments: number;
+        totalSections: number;
+        categories: string[];
+        loaders: string[];
+        versions: string[];
+    };
+    formatForAI(results: SearchResult[], query: string): string;
+    close(): void;
+}
+//# sourceMappingURL=search-service.d.ts.map

package/dist/services/search-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-service.d.ts","sourceRoot":"","sources":["../../src/services/search-service.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0ED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,CAAC,EAAE,MAAM;IAWrB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyF7D,OAAO,CAAC,gBAAgB;YAYV,mBAAmB;IAuEjC,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,iBAAiB;IAmCzB,OAAO,CAAC,oBAAoB;IAgE5B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAmFvB,OAAO,CAAC,kBAAkB;IA2C1B,OAAO,CAAC,iBAAiB;IA+DzB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,sBAAsB;IAkD9B,OAAO,CAAC,eAAe;IAiDvB,OAAO,CAAC,iBAAiB;IAyCzB,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;IAgBD,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IA8C3D,KAAK;CAGN"}