@contiva/sapbtp-docs-mcp 1.0.1

package/build/search/title.js

@@ -0,0 +1,95 @@
+import { normalizeText, fuzzyMatchScore, containsAllWords, tokenize } from '../utils/text-processing.js';
+/**
+ * Title-based search implementation
+ */
+export class TitleSearch {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Performs title-based search
+     */
+    async search(options) {
+        const { query, area = 'all', limit = 15 } = options;
+        // Get files to search
+        const files = area === 'all'
+            ? this.registry.getAllFiles()
+            : this.registry.getByArea(area);
+        // Score each file by title
+        const scoredResults = files.map(file => {
+            const score = this.scoreTitle(file.title, query);
+            if (score > 0) {
+                return {
+                    result: {
+                        filePath: file.filePath,
+                        relativePath: file.relativePath,
+                        title: file.title,
+                        loioId: file.loioId,
+                        snippet: file.title, // Use title as snippet for title search
+                        score,
+                        matchType: 'title',
+                        area: file.area,
+                    },
+                    score,
+                };
+            }
+            return null;
+        }).filter((r) => r !== null);
+        // Sort by score (descending)
+        scoredResults.sort((a, b) => b.score - a.score);
+        // Return top results
+        return scoredResults.slice(0, limit).map(r => r.result);
+    }
+    /**
+     * Scores a title based on query relevance
+     */
+    scoreTitle(title, query) {
+        const normalizedTitle = normalizeText(title);
+        const normalizedQuery = normalizeText(query);
+        let score = 0;
+        // Exact match (case-insensitive)
+        if (normalizedTitle === normalizedQuery) {
+            return 100;
+        }
+        // Exact match (case-sensitive)
+        if (title === query) {
+            return 95;
+        }
+        // Contains exact query
+        if (normalizedTitle.includes(normalizedQuery)) {
+            score += 80;
+        }
+        // Starts with query
+        if (normalizedTitle.startsWith(normalizedQuery)) {
+            score += 70;
+        }
+        // Contains all words from query
+        if (containsAllWords(title, query)) {
+            score += 60;
+        }
+        // Fuzzy match (Levenshtein distance)
+        const fuzzyScore = fuzzyMatchScore(title, query);
+        if (fuzzyScore > 70) {
+            score += fuzzyScore / 2; // Reduce weight of fuzzy matches
+        }
+        // Individual word matches
+        const titleTokens = tokenize(title);
+        const queryTokens = tokenize(query);
+        for (const queryToken of queryTokens) {
+            for (const titleToken of titleTokens) {
+                if (titleToken === queryToken) {
+                    score += 20; // Exact word match
+                }
+                else if (titleToken.startsWith(queryToken)) {
+                    score += 10; // Word prefix match
+                }
+                else if (titleToken.includes(queryToken)) {
+                    score += 5; // Partial word match
+                }
+            }
+        }
+        return score;
+    }
+}
+//# sourceMappingURL=title.js.map

package/build/search/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../src/search/title.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEzG;;GAEG;AACH,MAAM,OAAO,WAAW;IACF;IAApB,YAAoB,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;IAAG,CAAC;IAE9C;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAA2B;QACtC,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QAEpD,sBAAsB;QACtB,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK;YAC1B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;YAC7B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAElC,2BAA2B;QAC3B,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAEjD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,OAAO;oBACL,MAAM,EAAE;wBACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,YAAY,EAAE,IAAI,CAAC,YAAY;wBAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,wCAAwC;wBAC7D,KAAK;wBACL,SAAS,EAAE,OAAgB;wBAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;qBAChB;oBACD,KAAK;iBACN,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAmD,CAAC;QAE/E,6BAA6B;QAC7B,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAEhD,qBAAqB;QACrB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,KAAa,EAAE,KAAa;QAC7C,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAE7C,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,iCAAiC;QACjC,IAAI,eAAe,KAAK,eAAe,EAAE,CAAC;YACxC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,+BAA+B;QAC/B,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,uBAAuB;QACvB,IAAI,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC9C,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,oBAAoB;QACpB,IAAI,eAAe,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChD,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,gCAAgC;QAChC,IAAI,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACnC,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,qCAAqC;QACrC,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;YACpB,KAAK,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,iCAAiC;QAC5D,CAAC;QAED,0BAA0B;QAC1B,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEpC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC9B,KAAK,IAAI,EAAE,CAAC,CAAC,mBAAmB;gBAClC,CAAC;qBAAM,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC7C,KAAK,IAAI,EAAE,CAAC,CAAC,oBAAoB;gBACnC,CAAC;qBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3C,KAAK,IAAI,CAAC,CAAC,CAAC,qBAAqB;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/build/server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SAP Business Technology Platform Documentation MCP Server
+ */
+export declare class SAPISDocsServer {
+    private server;
+    private config;
+    private fileRegistry;
+    private topicIndex;
+    private fileCache;
+    private searchCache;
+    private fulltextSearch;
+    private titleSearch;
+    private semanticSearch;
+    private searchTool;
+    private readArticleTool;
+    private listTopicsTool;
+    private getRelatedTool;
+    constructor();
+    /**
+     * Initializes the server components
+     */
+    initialize(): Promise<void>;
+    /**
+     * Sets up request handlers
+     */
+    private setupHandlers;
+    /**
+     * Starts the server
+     */
+    start(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAe;IAG7B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAe;IAGlC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,cAAc,CAAkB;IAGxC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,cAAc,CAA0B;;IA6BhD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDjC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqFrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/build/server.js

@@ -0,0 +1,183 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { FileRegistry } from './indexing/file-registry.js';
+import { TopicIndex } from './indexing/topic-index.js';
+import { FileCache } from './cache/file-cache.js';
+import { SearchCache } from './cache/search-cache.js';
+import { FullTextSearch } from './search/fulltext.js';
+import { TitleSearch } from './search/title.js';
+import { SemanticSearch } from './search/semantic.js';
+import { SearchTool } from './tools/search.js';
+import { ReadArticleTool } from './tools/read-article.js';
+import { ListTopicsTool } from './tools/list-topics.js';
+import { GetRelatedArticlesTool } from './tools/get-related.js';
+import { resolveDocsPath, resolveCacheDir } from './utils/paths.js';
+import { ensureDocsAvailable } from './utils/docs-downloader.js';
+/**
+ * SAP Business Technology Platform Documentation MCP Server
+ */
+export class SAPISDocsServer {
+    server;
+    config;
+    // Components
+    fileRegistry;
+    topicIndex;
+    fileCache;
+    searchCache;
+    // Search engines
+    fulltextSearch;
+    titleSearch;
+    semanticSearch;
+    // Tools
+    searchTool;
+    readArticleTool;
+    listTopicsTool;
+    getRelatedTool;
+    constructor() {
+        this.server = new Server({
+            name: 'sapbtp-docs-mcp',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Load configuration
+        this.config = {
+            docsPath: resolveDocsPath(),
+            cacheDir: resolveCacheDir(),
+            fileCacheSize: parseInt(process.env.MCP_FILE_CACHE_SIZE || '100'),
+            searchCacheTTL: parseInt(process.env.MCP_SEARCH_CACHE_TTL || '300'),
+            embeddingProvider: process.env.EMBEDDING_PROVIDER || 'local',
+            voyageApiKey: process.env.VOYAGE_API_KEY,
+            openaiApiKey: process.env.OPENAI_API_KEY,
+        };
+        this.setupHandlers();
+    }
+    /**
+     * Initializes the server components
+     */
+    async initialize() {
+        console.error('Initializing SAP Business Technology Platform Documentation MCP Server...');
+        console.error(`Docs path: ${this.config.docsPath}`);
+        console.error(`Cache dir: ${this.config.cacheDir}`);
+        console.error(`Embedding provider: ${this.config.embeddingProvider}`);
+        // Ensure documentation is available (download if necessary)
+        const docsAvailable = await ensureDocsAvailable(this.config.docsPath);
+        if (!docsAvailable) {
+            throw new Error('Documentation not available and download failed. Please see instructions above.');
+        }
+        // Initialize caches
+        this.fileCache = new FileCache(this.config.fileCacheSize);
+        this.searchCache = new SearchCache(this.config.searchCacheTTL);
+        // Initialize indexing
+        this.fileRegistry = new FileRegistry(this.config.docsPath);
+        await this.fileRegistry.build();
+        this.topicIndex = new TopicIndex(this.config.docsPath);
+        await this.topicIndex.build();
+        // Initialize search engines
+        this.fulltextSearch = new FullTextSearch(this.fileRegistry, this.fileCache);
+        this.titleSearch = new TitleSearch(this.fileRegistry);
+        this.semanticSearch = new SemanticSearch(this.fileRegistry, this.fileCache);
+        // Initialize tools
+        this.searchTool = new SearchTool(this.fulltextSearch, this.titleSearch, this.semanticSearch, this.searchCache);
+        this.readArticleTool = new ReadArticleTool(this.fileRegistry, this.fileCache);
+        this.listTopicsTool = new ListTopicsTool(this.topicIndex);
+        this.getRelatedTool = new GetRelatedArticlesTool(this.fileRegistry, this.fileCache, this.semanticSearch);
+        console.error('Server initialized successfully!');
+        console.error(`Ready to search ${this.fileRegistry.size()} documentation files`);
+    }
+    /**
+     * Sets up request handlers
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    SearchTool.getSchema(),
+                    ReadArticleTool.getSchema(),
+                    ListTopicsTool.getSchema(),
+                    GetRelatedArticlesTool.getSchema(),
+                ],
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            try {
+                const { name, arguments: args } = request.params;
+                switch (name) {
+                    case 'search_documentation': {
+                        const result = await this.searchTool.execute(args);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'read_article': {
+                        const result = await this.readArticleTool.execute(args);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'list_topics': {
+                        const result = await this.listTopicsTool.execute(args);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    case 'get_related_articles': {
+                        const result = await this.getRelatedTool.execute(args);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result, null, 2),
+                                },
+                            ],
+                        };
+                    }
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${errorMessage}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Starts the server
+     */
+    async start() {
+        await this.initialize();
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('Server running on stdio');
+    }
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

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

package/build/tools/get-related.d.ts

@@ -0,0 +1,64 @@
+import type { GetRelatedArticlesInput, GetRelatedArticlesOutput } from '../types/index.js';
+import { FileRegistry } from '../indexing/file-registry.js';
+import { FileCache } from '../cache/file-cache.js';
+import { SemanticSearch } from '../search/semantic.js';
+/**
+ * Get related articles tool handler
+ */
+export declare class GetRelatedArticlesTool {
+    private registry;
+    private fileCache;
+    private semanticSearch;
+    constructor(registry: FileRegistry, fileCache: FileCache, semanticSearch: SemanticSearch);
+    /**
+     * Finds articles related to a given article
+     */
+    execute(input: GetRelatedArticlesInput): Promise<GetRelatedArticlesOutput>;
+    /**
+     * Finds related articles based on links
+     */
+    private findByLinks;
+    /**
+     * Finds related articles based on semantic similarity
+     */
+    private findBySemantic;
+    /**
+     * Deduplicates and sorts related articles
+     */
+    private deduplicateAndSort;
+    /**
+     * Resolves identifier to file path
+     */
+    private resolveIdentifier;
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema(): {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                identifier: {
+                    type: string;
+                    description: string;
+                };
+                method: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                    default: number;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+            required: string[];
+        };
+    };
+}
+//# sourceMappingURL=get-related.d.ts.map

package/build/tools/get-related.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-related.d.ts","sourceRoot":"","sources":["../../src/tools/get-related.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAkB,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD;;GAEG;AACH,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,cAAc;gBAFd,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,cAAc;IAGxC;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAuChF;;OAEG;YACW,WAAW;IAwBzB;;OAEG;YACW,cAAc;IAiD5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BjB"}

package/build/tools/get-related.js

@@ -0,0 +1,203 @@
+import { cosineSimilarity } from '../utils/text-processing.js';
+import { existsSync } from 'fs';
+/**
+ * Get related articles tool handler
+ */
+export class GetRelatedArticlesTool {
+    registry;
+    fileCache;
+    semanticSearch;
+    constructor(registry, fileCache, semanticSearch) {
+        this.registry = registry;
+        this.fileCache = fileCache;
+        this.semanticSearch = semanticSearch;
+    }
+    /**
+     * Finds articles related to a given article
+     */
+    async execute(input) {
+        const { identifier, method = 'both', limit = 10 } = input;
+        // Resolve identifier to file path
+        const filePath = this.resolveIdentifier(identifier);
+        if (!filePath) {
+            throw new Error(`Article not found: ${identifier}`);
+        }
+        // Get source document
+        const sourceDoc = await this.fileCache.get(filePath);
+        // Find related articles based on method
+        let relatedArticles = [];
+        if (method === 'links' || method === 'both') {
+            const linkRelated = await this.findByLinks(filePath);
+            relatedArticles.push(...linkRelated);
+        }
+        if (method === 'semantic' || method === 'both') {
+            const semanticRelated = await this.findBySemantic(filePath, limit);
+            relatedArticles.push(...semanticRelated);
+        }
+        // Deduplicate and sort
+        const deduped = this.deduplicateAndSort(relatedArticles, limit);
+        return {
+            sourceArticle: {
+                title: sourceDoc.title,
+                filePath: sourceDoc.metadata.filePath,
+                loioId: sourceDoc.loioId,
+            },
+            relatedArticles: deduped,
+        };
+    }
+    /**
+     * Finds related articles based on links
+     */
+    async findByLinks(filePath) {
+        const doc = await this.fileCache.get(filePath);
+        const relatedArticles = [];
+        // Get all internal links
+        const internalLinks = doc.links.filter(link => !link.isExternal && existsSync(link.absolutePath));
+        for (const link of internalLinks) {
+            const entry = this.registry.getByPath(link.absolutePath);
+            if (entry) {
+                relatedArticles.push({
+                    title: entry.title,
+                    filePath: link.absolutePath,
+                    relationshipType: 'explicit_link',
+                    score: 100, // Explicit links get highest score
+                    loioId: entry.loioId,
+                });
+            }
+        }
+        return relatedArticles;
+    }
+    /**
+     * Finds related articles based on semantic similarity
+     */
+    async findBySemantic(filePath, limit) {
+        try {
+            // Get embedding for source document
+            const sourceEmbedding = await this.semanticSearch.getDocumentEmbedding(filePath);
+            if (!sourceEmbedding) {
+                return [];
+            }
+            // Get all files
+            const files = this.registry.getAllFiles();
+            const similarities = [];
+            // Calculate similarity to each file
+            for (const file of files) {
+                // Skip the source file itself
+                if (file.filePath === filePath) {
+                    continue;
+                }
+                const embedding = await this.semanticSearch.getDocumentEmbedding(file.filePath);
+                if (embedding) {
+                    const similarity = cosineSimilarity(sourceEmbedding, embedding);
+                    const score = similarity * 100;
+                    if (score > 50) { // Only include if reasonably similar
+                        similarities.push({ file, score });
+                    }
+                }
+            }
+            // Sort by score and take top results
+            similarities.sort((a, b) => b.score - a.score);
+            return similarities.slice(0, limit).map(({ file, score }) => ({
+                title: file.title,
+                filePath: file.filePath,
+                relationshipType: 'semantic',
+                score,
+                loioId: file.loioId,
+            }));
+        }
+        catch (error) {
+            // Semantic search might not be initialized
+            console.error('Semantic search not available:', error);
+            return [];
+        }
+    }
+    /**
+     * Deduplicates and sorts related articles
+     */
+    deduplicateAndSort(articles, limit) {
+        const fileMap = new Map();
+        for (const article of articles) {
+            const existing = fileMap.get(article.filePath);
+            if (!existing) {
+                fileMap.set(article.filePath, article);
+            }
+            else {
+                // Keep the one with higher score, or prefer explicit links
+                if (article.score > existing.score) {
+                    article.relationshipType = existing.relationshipType === 'explicit_link'
+                        ? 'combined'
+                        : article.relationshipType;
+                    fileMap.set(article.filePath, article);
+                }
+                else if (article.relationshipType === 'explicit_link') {
+                    existing.relationshipType = 'combined';
+                    existing.score = Math.max(existing.score, article.score);
+                }
+            }
+        }
+        // Convert to array and sort
+        return Array.from(fileMap.values())
+            .sort((a, b) => {
+            // Prioritize explicit links
+            if (a.relationshipType === 'explicit_link' && b.relationshipType !== 'explicit_link') {
+                return -1;
+            }
+            if (b.relationshipType === 'explicit_link' && a.relationshipType !== 'explicit_link') {
+                return 1;
+            }
+            // Then sort by score
+            return b.score - a.score;
+        })
+            .slice(0, limit);
+    }
+    /**
+     * Resolves identifier to file path
+     */
+    resolveIdentifier(identifier) {
+        // Check if it's a LOIO ID
+        if (identifier.startsWith('loio')) {
+            const entry = this.registry.getByLoioId(identifier);
+            return entry ? entry.filePath : null;
+        }
+        // Check if it's a direct file path
+        if (existsSync(identifier)) {
+            return identifier;
+        }
+        // Try to find in registry
+        const entry = this.registry.getByPath(identifier);
+        return entry ? entry.filePath : null;
+    }
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema() {
+        return {
+            name: 'get_related_articles',
+            description: 'Find articles related to a given article based on links and content similarity.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    identifier: {
+                        type: 'string',
+                        description: 'File path or LOIO ID of the article'
+                    },
+                    method: {
+                        type: 'string',
+                        enum: ['links', 'semantic', 'both'],
+                        description: 'How to find related articles: links (explicit references), semantic (similar content), both',
+                        default: 'both'
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of related articles to return',
+                        default: 10,
+                        minimum: 1,
+                        maximum: 30
+                    }
+                },
+                required: ['identifier']
+            }
+        };
+    }
+}
+//# sourceMappingURL=get-related.js.map

package/build/tools/get-related.js.map

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

package/build/tools/list-topics.d.ts

@@ -0,0 +1,43 @@
+import type { ListTopicsInput, TopicHierarchy } from '../types/index.js';
+import { TopicIndex } from '../indexing/topic-index.js';
+/**
+ * List topics tool handler
+ */
+export declare class ListTopicsTool {
+    private topicIndex;
+    constructor(topicIndex: TopicIndex);
+    /**
+     * Lists documentation topics in hierarchical structure
+     */
+    execute(input: ListTopicsInput): Promise<TopicHierarchy>;
+    /**
+     * Gets the tool schema for MCP
+     */
+    static getSchema(): {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                area: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                depth: {
+                    type: string;
+                    description: string;
+                    default: number;
+                    minimum: number;
+                    maximum: number;
+                };
+                parentPath: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+}
+//# sourceMappingURL=list-topics.d.ts.map

package/build/tools/list-topics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-topics.d.ts","sourceRoot":"","sources":["../../src/tools/list-topics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD;;GAEG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAE1C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB9D;;OAEG;IACH,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB"}