@iflow-mcp/jeanibarz-knowledge-base-mcp-server 0.1.0

package/build/FaissIndexManager.test.js

@@ -0,0 +1,121 @@
+import * as fsp from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+const saveMock = jest.fn();
+const addDocumentsMock = jest.fn();
+const fromTextsMock = jest.fn();
+const loadMock = jest.fn();
+const similaritySearchMock = jest.fn();
+class MockFaissStore {
+    async addDocuments(...args) {
+        return addDocumentsMock(...args);
+    }
+    async save(...args) {
+        return saveMock(...args);
+    }
+    async similaritySearchWithScore(...args) {
+        return similaritySearchMock(...args);
+    }
+    static async fromTexts(...args) {
+        fromTextsMock(...args);
+        return new MockFaissStore();
+    }
+    static async load(...args) {
+        loadMock(...args);
+        return new MockFaissStore();
+    }
+}
+jest.mock('@langchain/community/embeddings/hf', () => ({
+    __esModule: true,
+    HuggingFaceInferenceEmbeddings: class MockEmbedding {
+        _config;
+        constructor(_config) {
+            this._config = _config;
+        }
+    },
+}));
+jest.mock('@langchain/community/vectorstores/faiss', () => ({
+    __esModule: true,
+    FaissStore: MockFaissStore,
+}));
+function createPermissionError(message) {
+    const error = new Error(message);
+    error.code = 'EACCES';
+    return error;
+}
+describe('FaissIndexManager permission handling', () => {
+    const originalEnv = {
+        KNOWLEDGE_BASES_ROOT_DIR: process.env.KNOWLEDGE_BASES_ROOT_DIR,
+        FAISS_INDEX_PATH: process.env.FAISS_INDEX_PATH,
+        EMBEDDING_PROVIDER: process.env.EMBEDDING_PROVIDER,
+        HUGGINGFACE_API_KEY: process.env.HUGGINGFACE_API_KEY,
+        LOG_FILE: process.env.LOG_FILE,
+    };
+    beforeEach(() => {
+        saveMock.mockReset();
+        addDocumentsMock.mockReset();
+        fromTextsMock.mockReset();
+        loadMock.mockReset();
+        similaritySearchMock.mockReset();
+    });
+    afterEach(() => {
+        const keys = Object.keys(originalEnv);
+        for (const key of keys) {
+            const value = originalEnv[key];
+            if (value === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = value;
+            }
+        }
+        jest.restoreAllMocks();
+    });
+    it('throws explicit error when FAISS directory cannot be created', async () => {
+        const tempDir = await fsp.mkdtemp(path.join(os.tmpdir(), 'kb-faiss-init-'));
+        const lockedDir = path.join(tempDir, 'locked');
+        await fsp.mkdir(lockedDir, { recursive: true });
+        await fsp.chmod(lockedDir, 0o500);
+        process.env.KNOWLEDGE_BASES_ROOT_DIR = tempDir;
+        process.env.FAISS_INDEX_PATH = path.join(lockedDir, '.faiss');
+        process.env.EMBEDDING_PROVIDER = 'huggingface';
+        process.env.HUGGINGFACE_API_KEY = 'test-key';
+        try {
+            jest.resetModules();
+            const loggerModule = await import('./logger.js');
+            const loggerErrorSpy = jest.spyOn(loggerModule.logger, 'error');
+            const { FaissIndexManager } = await import('./FaissIndexManager.js');
+            const manager = new FaissIndexManager();
+            await expect(manager.initialize()).rejects.toThrow(/Permission denied/);
+            expect(loggerErrorSpy).toHaveBeenCalledWith(expect.stringContaining('Permission denied'));
+        }
+        finally {
+            await fsp.chmod(lockedDir, 0o700);
+        }
+    });
+    it('logs permission errors to file when saving FAISS index fails', async () => {
+        const tempDir = await fsp.mkdtemp(path.join(os.tmpdir(), 'kb-faiss-update-'));
+        const kbDir = path.join(tempDir, 'kb');
+        const defaultKb = path.join(kbDir, 'default');
+        await fsp.mkdir(defaultKb, { recursive: true });
+        const docPath = path.join(defaultKb, 'doc.md');
+        await fsp.writeFile(docPath, '# Title\n\nSome content for embeddings.');
+        const logFile = path.join(tempDir, 'logs', 'kb.log');
+        process.env.KNOWLEDGE_BASES_ROOT_DIR = kbDir;
+        process.env.FAISS_INDEX_PATH = path.join(tempDir, '.faiss');
+        process.env.LOG_FILE = logFile;
+        process.env.EMBEDDING_PROVIDER = 'huggingface';
+        process.env.HUGGINGFACE_API_KEY = 'test-key';
+        saveMock.mockRejectedValue(createPermissionError('cannot write index'));
+        jest.resetModules();
+        const { FaissIndexManager } = await import('./FaissIndexManager.js');
+        const manager = new FaissIndexManager();
+        await manager.initialize();
+        await expect(manager.updateIndex()).rejects.toThrow(/Permission denied/);
+        expect(saveMock).toHaveBeenCalledWith(path.join(process.env.FAISS_INDEX_PATH, 'faiss.index'));
+        await new Promise((resolve) => setImmediate(resolve));
+        const logContents = await fsp.readFile(logFile, 'utf-8');
+        expect(logContents).toContain('Permission denied while attempting to save FAISS index at');
+    });
+});
+//# sourceMappingURL=FaissIndexManager.test.js.map

package/build/FaissIndexManager.test.js.map

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

package/build/KnowledgeBaseServer.js

@@ -0,0 +1,184 @@
+// KnowledgeBaseServer.ts
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
+import * as fsp from 'fs/promises';
+import { FaissIndexManager } from './FaissIndexManager.js';
+import { KNOWLEDGE_BASES_ROOT_DIR } from './config.js';
+import { logger } from './logger.js';
+export class KnowledgeBaseServer {
+    server;
+    faissManager;
+    constructor() {
+        this.faissManager = new FaissIndexManager();
+        logger.info('Initializing KnowledgeBaseServer');
+        this.server = new Server({
+            name: 'knowledge-base-server',
+            version: '0.1.0',
+        }, {
+            capabilities: {
+                resources: {},
+                tools: {},
+            },
+        });
+        this.setupToolHandlers();
+        this.server.onerror = (error) => logger.error('[MCP Error]', error);
+        process.on('SIGINT', async () => {
+            await this.server.close();
+            process.exit(0);
+        });
+    }
+    setupToolHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'list_knowledge_bases',
+                    description: 'Lists the available knowledge bases.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {},
+                        required: [],
+                    },
+                },
+                {
+                    name: 'retrieve_knowledge',
+                    description: 'Retrieves similar chunks from the knowledge base based on a query. Optionally, if a knowledge base is specified, only that one is searched; otherwise, all available knowledge bases are considered. By default, at most 10 documents are returned with a score below a threshold of 2. A different threshold can optionally be provided.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'The query text to use for semantic search.',
+                            },
+                            knowledge_base_name: {
+                                type: 'string',
+                                description: "Optional. Name of the knowledge base to query (e.g., 'company', 'it_support', 'onboarding'). If omitted, the search is performed across all available knowledge bases.",
+                            },
+                            threshold: {
+                                type: 'number',
+                                description: 'Optional. The maximum similarity score to return.',
+                            },
+                        },
+                        required: ['query'],
+                    },
+                },
+            ],
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            if (request.params.name === 'list_knowledge_bases') {
+                return this.handleListKnowledgeBases();
+            }
+            else if (request.params.name === 'retrieve_knowledge') {
+                return this.handleRetrieveKnowledge(request.params.arguments);
+            }
+            else {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
+            }
+        });
+    }
+    async handleListKnowledgeBases() {
+        try {
+            const entries = await fsp.readdir(KNOWLEDGE_BASES_ROOT_DIR);
+            const knowledgeBases = entries.filter((entry) => !entry.startsWith('.'));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(knowledgeBases, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Error listing knowledge bases:', error);
+            if (error?.stack) {
+                logger.error(error.stack);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing knowledge bases: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async handleRetrieveKnowledge(args) {
+        if (!args || typeof args.query !== 'string') {
+            throw new McpError(ErrorCode.InvalidParams, 'Invalid arguments for retrieve_knowledge: missing query');
+        }
+        const query = args.query;
+        const knowledgeBaseName = typeof args.knowledge_base_name === 'string' ? args.knowledge_base_name : undefined;
+        const threshold = typeof args.threshold === 'number' ? args.threshold : undefined;
+        try {
+            const startTime = Date.now();
+            logger.debug(`[${startTime}] handleRetrieveKnowledge started`);
+            // Update FAISS index: if a specific knowledge base is provided, update only that one; otherwise update all.
+            await this.faissManager.updateIndex(knowledgeBaseName);
+            logger.debug(`[${Date.now()}] FAISS index update completed`);
+            // Perform similarity search using the provided query.
+            const similaritySearchResults = await this.faissManager.similaritySearch(query, 10, threshold);
+            logger.debug(`[${Date.now()}] Similarity search completed`);
+            // Build a nicely formatted markdown response including the similarity score.
+            let formattedResults = '';
+            if (similaritySearchResults && similaritySearchResults.length > 0) {
+                formattedResults = similaritySearchResults
+                    .map((doc, idx) => {
+                    const resultHeader = `**Result ${idx + 1}:**`;
+                    const content = doc.pageContent.trim();
+                    const metadata = JSON.stringify(doc.metadata, null, 2);
+                    const scoreText = doc.score !== undefined ? `**Score:** ${doc.score.toFixed(2)}\n\n` : '';
+                    return `${resultHeader}\n\n${scoreText}${content}\n\n**Source:**\n\`\`\`json\n${metadata}\n\`\`\``;
+                })
+                    .join('\n\n---\n\n');
+            }
+            else {
+                formattedResults = '_No similar results found._';
+            }
+            const disclaimer = '\n\n> **Disclaimer:** The provided results might not all be relevant. Please cross-check the relevance of the information.';
+            const responseText = `## Semantic Search Results\n\n${formattedResults}${disclaimer}`;
+            const endTime = Date.now();
+            logger.debug(`[${endTime}] handleRetrieveKnowledge completed in ${endTime - startTime}ms`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: responseText,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('Error retrieving knowledge:', error);
+            if (error?.stack) {
+                logger.error(error.stack);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving knowledge: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    async run() {
+        try {
+            const transport = new StdioServerTransport();
+            await this.server.connect(transport);
+            logger.info('Knowledge Base MCP server running on stdio');
+            await this.faissManager.initialize();
+        }
+        catch (error) {
+            logger.error('Error during server startup:', error);
+            if (error?.stack) {
+                logger.error(error.stack);
+            }
+        }
+    }
+}
+//# sourceMappingURL=KnowledgeBaseServer.js.map

package/build/KnowledgeBaseServer.js.map

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

package/build/config.js

@@ -0,0 +1,17 @@
+import * as path from 'path';
+import * as os from 'os';
+export const KNOWLEDGE_BASES_ROOT_DIR = process.env.KNOWLEDGE_BASES_ROOT_DIR ||
+    path.join(os.homedir(), 'knowledge_bases');
+export const DEFAULT_FAISS_INDEX_PATH = path.join(KNOWLEDGE_BASES_ROOT_DIR, '.faiss');
+export const FAISS_INDEX_PATH = process.env.FAISS_INDEX_PATH || DEFAULT_FAISS_INDEX_PATH;
+// Embedding provider configuration
+export const EMBEDDING_PROVIDER = process.env.EMBEDDING_PROVIDER || 'huggingface';
+// HuggingFace configuration
+export const DEFAULT_HUGGINGFACE_MODEL_NAME = 'sentence-transformers/all-MiniLM-L6-v2';
+export const HUGGINGFACE_MODEL_NAME = process.env.HUGGINGFACE_MODEL_NAME || DEFAULT_HUGGINGFACE_MODEL_NAME;
+// Ollama configuration
+export const OLLAMA_BASE_URL = process.env.OLLAMA_BASE_URL || 'http://localhost:11434';
+export const OLLAMA_MODEL = process.env.OLLAMA_MODEL || 'dengcao/Qwen3-Embedding-0.6B:Q8_0';
+// OpenAI configuration
+export const OPENAI_MODEL_NAME = process.env.OPENAI_MODEL_NAME || 'text-embedding-ada-002';
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB;IAC1E,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAE7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,wBAAwB,CAAC;AAEzF,mCAAmC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,aAAa,CAAC;AAElF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,8BAA8B,GAAG,wCAAwC,CAAC;AACvF,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,8BAA8B,CAAC;AAE3G,uBAAuB;AACvB,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,wBAAwB,CAAC;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,mCAAmC,CAAC;AAE5F,uBAAuB;AACvB,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,wBAAwB,CAAC"}

package/build/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { logger } from './logger.js';
+import { KnowledgeBaseServer } from './KnowledgeBaseServer.js';
+const server = new KnowledgeBaseServer();
+server.run().catch((error) => {
+    logger.error('Unhandled server error:', error);
+    if (error?.stack) {
+        logger.error(error.stack);
+    }
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;AACzC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC3B,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,KAAK,EAAE,KAAK,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC,CAAC,CAAC"}

package/build/logger.js

@@ -0,0 +1,72 @@
+import { appendFileSync, createWriteStream, existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+import { format } from 'util';
+const LEVEL_PRIORITY = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+const envLevel = (process.env.LOG_LEVEL || 'info').toLowerCase();
+const activeLevel = LEVEL_PRIORITY[envLevel] ? envLevel : 'info';
+const destinations = [process.stderr];
+const logFilePath = process.env.LOG_FILE;
+if (logFilePath) {
+    try {
+        const parentDir = dirname(logFilePath);
+        if (!existsSync(parentDir)) {
+            mkdirSync(parentDir, { recursive: true });
+        }
+        appendFileSync(logFilePath, '');
+        const stream = createWriteStream(logFilePath, { flags: 'a' });
+        stream.on('error', (error) => {
+            const message = `${new Date().toISOString()} [ERROR] Log file stream error for ${logFilePath}: ${format(error)}`;
+            process.stderr.write(`${message}\n`);
+        });
+        destinations.push(stream);
+        try {
+            stream.write('');
+        }
+        catch (error) {
+            const message = `${new Date().toISOString()} [ERROR] Failed to prime log file ${logFilePath}: ${format(error)}`;
+            process.stderr.write(`${message}\n`);
+        }
+        process.on('exit', () => {
+            try {
+                stream.end();
+            }
+            catch (error) {
+                // noop – logging best effort on shutdown
+            }
+        });
+    }
+    catch (error) {
+        const message = `${new Date().toISOString()} [ERROR] Failed to initialize log file ${logFilePath}: ${format(error)}`;
+        process.stderr.write(`${message}\n`);
+    }
+}
+function write(level, args) {
+    if (LEVEL_PRIORITY[level] < LEVEL_PRIORITY[activeLevel]) {
+        return;
+    }
+    const message = format(...args);
+    const line = `${new Date().toISOString()} [${level.toUpperCase()}] ${message}\n`;
+    for (const destination of destinations) {
+        try {
+            destination.write(line);
+        }
+        catch (error) {
+            // If writing to a destination fails, fall back to stderr without recursion.
+            if (destination !== process.stderr) {
+                process.stderr.write(`${new Date().toISOString()} [ERROR] Failed to write log: ${format(error)}\n`);
+            }
+        }
+    }
+}
+export const logger = {
+    debug: (...args) => write('debug', args),
+    info: (...args) => write('info', args),
+    warn: (...args) => write('warn', args),
+    error: (...args) => write('error', args),
+};
+//# sourceMappingURL=logger.js.map

package/build/logger.js.map

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

package/build/logger.test.js

@@ -0,0 +1,63 @@
+import * as fsp from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+describe('logger', () => {
+    const originalEnv = {
+        LOG_FILE: process.env.LOG_FILE,
+        LOG_LEVEL: process.env.LOG_LEVEL,
+    };
+    afterEach(() => {
+        if (originalEnv.LOG_FILE === undefined) {
+            delete process.env.LOG_FILE;
+        }
+        else {
+            process.env.LOG_FILE = originalEnv.LOG_FILE;
+        }
+        if (originalEnv.LOG_LEVEL === undefined) {
+            delete process.env.LOG_LEVEL;
+        }
+        else {
+            process.env.LOG_LEVEL = originalEnv.LOG_LEVEL;
+        }
+        jest.restoreAllMocks();
+        jest.resetModules();
+    });
+    it('writes log messages to the configured file', async () => {
+        const tempDir = await fsp.mkdtemp(path.join(os.tmpdir(), 'kb-logger-file-'));
+        const logFile = path.join(tempDir, 'logs', 'app.log');
+        process.env.LOG_FILE = logFile;
+        process.env.LOG_LEVEL = 'debug';
+        await jest.isolateModulesAsync(async () => {
+            const { logger } = await import('./logger.js');
+            logger.info('File target message');
+            logger.debug('debug content');
+            await new Promise((resolve) => setImmediate(resolve));
+        });
+        await expect(fsp.stat(path.dirname(logFile))).resolves.toBeTruthy();
+        const fileContents = await fsp.readFile(logFile, 'utf-8');
+        expect(fileContents).toContain('File target message');
+        expect(fileContents).toContain('[DEBUG] debug content');
+    });
+    it('falls back to stderr when log file cannot be initialized', async () => {
+        const stderrSpy = jest.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        const tempDir = await fsp.mkdtemp(path.join(os.tmpdir(), 'kb-logger-stderr-'));
+        const lockedDir = path.join(tempDir, 'locked');
+        await fsp.mkdir(lockedDir, { recursive: true });
+        await fsp.chmod(lockedDir, 0o500);
+        const logFile = path.join(lockedDir, 'app.log');
+        process.env.LOG_FILE = logFile;
+        try {
+            await jest.isolateModulesAsync(async () => {
+                const { logger } = await import('./logger.js');
+                logger.info('Fallback message');
+                await new Promise((resolve) => setImmediate(resolve));
+            });
+        }
+        finally {
+            await fsp.chmod(lockedDir, 0o700);
+        }
+        const stderrOutput = stderrSpy.mock.calls.flat().join('');
+        expect(stderrOutput).toMatch(/Failed to (initialize|write log)|Log file stream error/);
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/build/logger.test.js.map

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

package/build/utils.js

@@ -0,0 +1,42 @@
+import * as crypto from 'crypto';
+import * as fsp from 'fs/promises';
+import * as path from 'path';
+import { logger } from './logger.js';
+export async function calculateSHA256(filePath) {
+    const fileBuffer = await fsp.readFile(filePath);
+    const hashSum = crypto.createHash('sha256');
+    hashSum.update(fileBuffer);
+    return hashSum.digest('hex');
+}
+/**
+ * Recursively gets all files in a directory, excluding hidden files and directories.
+ * @param dirPath The directory path to search
+ * @returns Array of file paths
+ */
+export async function getFilesRecursively(dirPath) {
+    const files = [];
+    async function traverse(currentPath) {
+        try {
+            const entries = await fsp.readdir(currentPath, { withFileTypes: true });
+            for (const entry of entries) {
+                // Skip hidden files and directories
+                if (entry.name.startsWith('.')) {
+                    continue;
+                }
+                const fullPath = path.join(currentPath, entry.name);
+                if (entry.isDirectory()) {
+                    await traverse(fullPath);
+                }
+                else if (entry.isFile()) {
+                    files.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            logger.error(`Error traversing directory ${currentPath}:`, error);
+        }
+    }
+    await traverse(dirPath);
+    return files;
+}
+//# sourceMappingURL=utils.js.map

package/build/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,UAAU,QAAQ,CAAC,WAAmB;QACzC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAExE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,oCAAoC;gBACpC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/B,SAAS;gBACX,CAAC;gBAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEpD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC3B,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/build/utils.test.js

@@ -0,0 +1,86 @@
+import { getFilesRecursively } from './utils.js';
+import * as fsp from 'fs/promises';
+import * as path from 'path';
+// Mock fs/promises
+jest.mock('fs/promises', () => ({
+    ...jest.requireActual('fs/promises'), // Import and retain default behavior
+    readdir: jest.fn(), // Mock readdir specifically
+}));
+describe('getFilesRecursively', () => {
+    const mockReaddir = fsp.readdir;
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    it('should return files recursively from nested directories', async () => {
+        // Mock directory structure:
+        // test_dir/
+        //   file1.txt
+        //   sub_dir/
+        //     file2.txt
+        //     nested_dir/
+        //       file3.txt
+        mockReaddir.mockImplementation(async (dirPath, options) => {
+            const dir = dirPath.toString();
+            if (dir === 'test_dir') {
+                return [
+                    { name: 'file1.txt', isDirectory: () => false, isFile: () => true },
+                    { name: 'sub_dir', isDirectory: () => true, isFile: () => false }
+                ];
+            }
+            else if (dir === path.join('test_dir', 'sub_dir')) {
+                return [
+                    { name: 'file2.txt', isDirectory: () => false, isFile: () => true },
+                    { name: 'nested_dir', isDirectory: () => true, isFile: () => false }
+                ];
+            }
+            else if (dir === path.join('test_dir', 'sub_dir', 'nested_dir')) {
+                return [
+                    { name: 'file3.txt', isDirectory: () => false, isFile: () => true }
+                ];
+            }
+            return [];
+        });
+        const files = await getFilesRecursively('test_dir');
+        expect(files).toEqual([
+            path.join('test_dir', 'file1.txt'),
+            path.join('test_dir', 'sub_dir', 'file2.txt'),
+            path.join('test_dir', 'sub_dir', 'nested_dir', 'file3.txt')
+        ]);
+    });
+    it('should skip hidden files and directories', async () => {
+        mockReaddir.mockImplementation(async (dirPath, options) => {
+            const dir = dirPath.toString();
+            if (dir === 'test_dir') {
+                return [
+                    { name: 'file1.txt', isDirectory: () => false, isFile: () => true },
+                    { name: '.hidden_file', isDirectory: () => false, isFile: () => true },
+                    { name: '.hidden_dir', isDirectory: () => true, isFile: () => false },
+                    { name: 'visible_dir', isDirectory: () => true, isFile: () => false }
+                ];
+            }
+            else if (dir === path.join('test_dir', 'visible_dir')) {
+                return [
+                    { name: 'file2.txt', isDirectory: () => false, isFile: () => true },
+                    { name: '.hidden_file2', isDirectory: () => false, isFile: () => true }
+                ];
+            }
+            return [];
+        });
+        const files = await getFilesRecursively('test_dir');
+        expect(files).toEqual([
+            path.join('test_dir', 'file1.txt'),
+            path.join('test_dir', 'visible_dir', 'file2.txt')
+        ]);
+    });
+    it('should handle empty directories', async () => {
+        mockReaddir.mockResolvedValue([]);
+        const files = await getFilesRecursively('empty_dir');
+        expect(files).toEqual([]);
+    });
+    it('should handle errors gracefully', async () => {
+        mockReaddir.mockRejectedValue(new Error('Permission denied'));
+        const files = await getFilesRecursively('error_dir');
+        expect(files).toEqual([]);
+    });
+});
+//# sourceMappingURL=utils.test.js.map