@contiva/sapbtp-docs-mcp 1.0.1

package/build/cache/file-cache.js

@@ -0,0 +1,124 @@
+import { stat } from 'fs/promises';
+import { parseMarkdown } from '../parsers/markdown.js';
+/**
+ * LRU Cache for parsed documents
+ */
+export class FileCache {
+    cache = new Map();
+    maxSize;
+    hits = 0;
+    misses = 0;
+    constructor(maxSize = 100) {
+        this.maxSize = maxSize;
+    }
+    /**
+     * Gets a parsed document from cache or parses it
+     */
+    async get(filePath) {
+        const cached = this.cache.get(filePath);
+        if (cached) {
+            // Check if file has been modified
+            try {
+                const stats = await stat(filePath);
+                if (cached.mtime && stats.mtime.getTime() === cached.mtime) {
+                    // Cache hit - move to end (most recently used)
+                    this.cache.delete(filePath);
+                    this.cache.set(filePath, cached);
+                    this.hits++;
+                    return cached.data;
+                }
+            }
+            catch (error) {
+                // File might not exist anymore, remove from cache
+                this.cache.delete(filePath);
+            }
+        }
+        // Cache miss - parse the file
+        this.misses++;
+        const document = await parseMarkdown(filePath);
+        // Add to cache
+        await this.set(filePath, document);
+        return document;
+    }
+    /**
+     * Sets a parsed document in the cache
+     */
+    async set(filePath, document) {
+        // Get file modification time
+        let mtime;
+        try {
+            const stats = await stat(filePath);
+            mtime = stats.mtime.getTime();
+        }
+        catch (error) {
+            // File might not exist, continue without mtime
+        }
+        // If cache is full, remove least recently used (first item)
+        if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(filePath, {
+            data: document,
+            timestamp: Date.now(),
+            mtime,
+        });
+    }
+    /**
+     * Checks if a file is in the cache and up-to-date
+     */
+    async has(filePath) {
+        const cached = this.cache.get(filePath);
+        if (!cached) {
+            return false;
+        }
+        // Check if file has been modified
+        try {
+            const stats = await stat(filePath);
+            return cached.mtime !== undefined && stats.mtime.getTime() === cached.mtime;
+        }
+        catch (error) {
+            // File might not exist, remove from cache
+            this.cache.delete(filePath);
+            return false;
+        }
+    }
+    /**
+     * Clears the entire cache
+     */
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    /**
+     * Removes a specific file from cache
+     */
+    invalidate(filePath) {
+        this.cache.delete(filePath);
+    }
+    /**
+     * Gets cache statistics
+     */
+    getStats() {
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            size: this.cache.size,
+            maxSize: this.maxSize,
+        };
+    }
+    /**
+     * Gets cache hit rate as a percentage
+     */
+    getHitRate() {
+        const total = this.hits + this.misses;
+        if (total === 0) {
+            return 0;
+        }
+        return (this.hits / total) * 100;
+    }
+}
+//# sourceMappingURL=file-cache.js.map

package/build/cache/file-cache.js.map

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

package/build/cache/search-cache.d.ts

@@ -0,0 +1,39 @@
+import type { SearchResult } from '../types/index.js';
+/**
+ * TTL-based cache for search results
+ */
+export declare class SearchCache {
+    private cache;
+    private ttl;
+    private maxSize;
+    constructor(ttlSeconds?: number);
+    /**
+     * Generates a cache key from search parameters
+     */
+    private generateKey;
+    /**
+     * Gets search results from cache
+     */
+    get(query: string, searchType: string, area: string): SearchResult[] | null;
+    /**
+     * Sets search results in cache
+     */
+    set(query: string, searchType: string, area: string, results: SearchResult[]): void;
+    /**
+     * Removes expired entries from cache
+     */
+    private cleanup;
+    /**
+     * Clears all cache entries
+     */
+    clear(): void;
+    /**
+     * Gets the number of entries in cache
+     */
+    size(): number;
+    /**
+     * Checks if a search query is cached and valid
+     */
+    has(query: string, searchType: string, area: string): boolean;
+}
+//# sourceMappingURL=search-cache.d.ts.map

package/build/cache/search-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-cache.d.ts","sourceRoot":"","sources":["../../src/cache/search-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAC;AAGlE;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAsD;IACnE,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAc;gBAEjB,UAAU,GAAE,MAAY;IAIpC;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,IAAI;IAkB3E;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAcnF;;OAEG;IACH,OAAO,CAAC,OAAO;IAuBf;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;CAW9D"}

package/build/cache/search-cache.js

@@ -0,0 +1,97 @@
+import { hashString } from '../utils/text-processing.js';
+/**
+ * TTL-based cache for search results
+ */
+export class SearchCache {
+    cache = new Map();
+    ttl; // Time to live in milliseconds
+    maxSize = 50;
+    constructor(ttlSeconds = 300) {
+        this.ttl = ttlSeconds * 1000;
+    }
+    /**
+     * Generates a cache key from search parameters
+     */
+    generateKey(query, searchType, area) {
+        const keyString = `${query}|${searchType}|${area}`;
+        return hashString(keyString);
+    }
+    /**
+     * Gets search results from cache
+     */
+    get(query, searchType, area) {
+        const key = this.generateKey(query, searchType, area);
+        const cached = this.cache.get(key);
+        if (!cached) {
+            return null;
+        }
+        // Check if cache entry has expired
+        const now = Date.now();
+        if (now - cached.timestamp > this.ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        return cached.data;
+    }
+    /**
+     * Sets search results in cache
+     */
+    set(query, searchType, area, results) {
+        const key = this.generateKey(query, searchType, area);
+        // If cache is full, remove oldest entries
+        if (this.cache.size >= this.maxSize) {
+            this.cleanup();
+        }
+        this.cache.set(key, {
+            data: results,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Removes expired entries from cache
+     */
+    cleanup() {
+        const now = Date.now();
+        const toDelete = [];
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > this.ttl) {
+                toDelete.push(key);
+            }
+        }
+        for (const key of toDelete) {
+            this.cache.delete(key);
+        }
+        // If still full after cleanup, remove oldest entry
+        if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+        }
+    }
+    /**
+     * Clears all cache entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Gets the number of entries in cache
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Checks if a search query is cached and valid
+     */
+    has(query, searchType, area) {
+        const key = this.generateKey(query, searchType, area);
+        const cached = this.cache.get(key);
+        if (!cached) {
+            return false;
+        }
+        const now = Date.now();
+        return now - cached.timestamp <= this.ttl;
+    }
+}
+//# sourceMappingURL=search-cache.js.map

package/build/cache/search-cache.js.map

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

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { SAPISDocsServer } from './server.js';
+/**
+ * Main entry point for the SAP Business Technology Platform Documentation MCP Server
+ */
+async function main() {
+    try {
+        const server = new SAPISDocsServer();
+        await server.start();
+    }
+    catch (error) {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/build/indexing/file-registry.d.ts

@@ -0,0 +1,47 @@
+import type { FileRegistryEntry, DocumentArea } from '../types/index.js';
+/**
+ * File Registry - maintains a fast lookup of all documentation files
+ */
+export declare class FileRegistry {
+    private registry;
+    private loioIndex;
+    private docsPath;
+    constructor(docsPath?: string);
+    /**
+     * Builds the file registry by scanning all documentation files
+     */
+    build(): Promise<void>;
+    /**
+     * Recursively scans a directory for markdown files
+     */
+    private scanDirectory;
+    /**
+     * Adds a file to the registry
+     */
+    private addFile;
+    /**
+     * Gets a file entry by path
+     */
+    getByPath(filePath: string): FileRegistryEntry | undefined;
+    /**
+     * Gets a file path by LOIO ID
+     */
+    getByLoioId(loioId: string): FileRegistryEntry | undefined;
+    /**
+     * Gets all files in a specific area
+     */
+    getByArea(area: DocumentArea): FileRegistryEntry[];
+    /**
+     * Gets all files
+     */
+    getAllFiles(): FileRegistryEntry[];
+    /**
+     * Searches files by title (case-insensitive partial match)
+     */
+    searchByTitle(query: string): FileRegistryEntry[];
+    /**
+     * Gets the total number of files in the registry
+     */
+    size(): number;
+}
+//# sourceMappingURL=file-registry.d.ts.map

package/build/indexing/file-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-registry.d.ts","sourceRoot":"","sources":["../../src/indexing/file-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIzE;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,CAAC,EAAE,MAAM;IAI7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;YACW,aAAa;IAmB3B;;OAEG;YACW,OAAO;IA4CrB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI1D;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAK1D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,EAAE;IAIlD;;OAEG;IACH,WAAW,IAAI,iBAAiB,EAAE;IAIlC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAOjD;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/build/indexing/file-registry.js

@@ -0,0 +1,130 @@
+import { readdir, readFile } from 'fs/promises';
+import { join } from 'path';
+import { resolveDocsPath, getRelativePath } from '../utils/paths.js';
+import { extractLoioId } from '../parsers/metadata.js';
+/**
+ * File Registry - maintains a fast lookup of all documentation files
+ */
+export class FileRegistry {
+    registry = new Map();
+    loioIndex = new Map(); // loioId -> filePath
+    docsPath;
+    constructor(docsPath) {
+        this.docsPath = docsPath || resolveDocsPath();
+    }
+    /**
+     * Builds the file registry by scanning all documentation files
+     */
+    async build() {
+        console.error('Building file registry...');
+        const startTime = Date.now();
+        const areas = ['ISuite', 'ci', 'apim'];
+        for (const area of areas) {
+            const areaPath = join(this.docsPath, area);
+            await this.scanDirectory(areaPath, area);
+        }
+        const elapsed = Date.now() - startTime;
+        console.error(`File registry built: ${this.registry.size} files in ${elapsed}ms`);
+    }
+    /**
+     * Recursively scans a directory for markdown files
+     */
+    async scanDirectory(dir, area) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    await this.scanDirectory(fullPath, area);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'index.md') {
+                    await this.addFile(fullPath, area);
+                }
+            }
+        }
+        catch (error) {
+            // Directory might not exist, skip
+            console.error(`Warning: Could not scan directory ${dir}`);
+        }
+    }
+    /**
+     * Adds a file to the registry
+     */
+    async addFile(filePath, area) {
+        try {
+            // Read just the first 1000 chars to find LOIO and title
+            const content = await readFile(filePath, 'utf-8');
+            const preview = content.substring(0, 1000);
+            const loioId = extractLoioId(preview);
+            // Extract title from first H1
+            const titleMatch = preview.match(/^#\s+(.+)$/m);
+            let title = '';
+            if (titleMatch) {
+                title = titleMatch[1].trim();
+            }
+            else {
+                // Fallback: use filename
+                const filename = filePath.split('/').pop() || filePath;
+                const withoutExt = filename.replace(/\.md$/, '');
+                const withoutHash = withoutExt.replace(/-[a-f0-9]{7}$/, '');
+                title = withoutHash
+                    .split('-')
+                    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+                    .join(' ');
+            }
+            const entry = {
+                filePath,
+                relativePath: getRelativePath(filePath, this.docsPath),
+                title,
+                loioId,
+                area,
+            };
+            this.registry.set(filePath, entry);
+            if (loioId) {
+                this.loioIndex.set(loioId, filePath);
+            }
+        }
+        catch (error) {
+            console.error(`Warning: Could not add file ${filePath} to registry`);
+        }
+    }
+    /**
+     * Gets a file entry by path
+     */
+    getByPath(filePath) {
+        return this.registry.get(filePath);
+    }
+    /**
+     * Gets a file path by LOIO ID
+     */
+    getByLoioId(loioId) {
+        const filePath = this.loioIndex.get(loioId);
+        return filePath ? this.registry.get(filePath) : undefined;
+    }
+    /**
+     * Gets all files in a specific area
+     */
+    getByArea(area) {
+        return Array.from(this.registry.values()).filter(entry => entry.area === area);
+    }
+    /**
+     * Gets all files
+     */
+    getAllFiles() {
+        return Array.from(this.registry.values());
+    }
+    /**
+     * Searches files by title (case-insensitive partial match)
+     */
+    searchByTitle(query) {
+        const normalizedQuery = query.toLowerCase();
+        return Array.from(this.registry.values()).filter(entry => entry.title.toLowerCase().includes(normalizedQuery));
+    }
+    /**
+     * Gets the total number of files in the registry
+     */
+    size() {
+        return this.registry.size;
+    }
+}
+//# sourceMappingURL=file-registry.js.map

package/build/indexing/file-registry.js.map

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

package/build/indexing/topic-index.d.ts

@@ -0,0 +1,57 @@
+import type { Topic, TopicHierarchy, DocumentArea } from '../types/index.js';
+/**
+ * Topic Index - parses index.md files to build hierarchical topic structure
+ */
+export declare class TopicIndex {
+    private hierarchies;
+    private docsPath;
+    constructor(docsPath?: string);
+    /**
+     * Builds the topic index by parsing index.md files
+     */
+    build(): Promise<void>;
+    /**
+     * Parses an index.md file to extract topic hierarchy
+     */
+    private parseIndexFile;
+    /**
+     * Parses topics from index.md content
+     * Expects format like:
+     * - [Topic Title](path/to/file.md)
+     *   - [Subtopic](path/to/subtopic.md)
+     */
+    private parseTopicsFromContent;
+    /**
+     * Counts total number of topics (including children)
+     */
+    private countTopics;
+    /**
+     * Gets the topic hierarchy for a specific area
+     */
+    getHierarchy(area: DocumentArea): TopicHierarchy | undefined;
+    /**
+     * Gets topics up to a specific depth
+     */
+    getTopicsWithDepth(area: DocumentArea, maxDepth: number): Topic[];
+    /**
+     * Filters topics by maximum depth
+     */
+    private filterByDepth;
+    /**
+     * Finds topics under a specific parent path
+     */
+    getTopicsUnderPath(area: DocumentArea, parentPath: string): Topic[];
+    /**
+     * Finds a topic by its path
+     */
+    private findTopicByPath;
+    /**
+     * Flattens the topic hierarchy into a list
+     */
+    flattenTopics(topics: Topic[]): Topic[];
+    /**
+     * Gets all topics for an area (flattened)
+     */
+    getAllTopics(area: DocumentArea): Topic[];
+}
+//# sourceMappingURL=topic-index.d.ts.map

package/build/indexing/topic-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-index.d.ts","sourceRoot":"","sources":["../../src/indexing/topic-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG7E;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAgD;IACnE,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,CAAC,EAAE,MAAM;IAI7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;OAEG;YACW,cAAc;IAa5B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAwD9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS;IAI5D;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE;IAUjE;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,EAAE;IAYnE;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE;IAWvC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,KAAK,EAAE;CAS1C"}