ai-prompt-guide-mcp 1.0.0

package/dist/utils/__tests__/path-handler.archive.test.js

@@ -0,0 +1,163 @@
+/**
+ * TDD tests for archive path generation with /archived/docs/ prefix
+ *
+ * These tests verify that documents archive to /archived/docs/ to preserve source context
+ * and distinguish documents from coordinator tasks in archives.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { DocumentManager } from '../../document-manager.js';
+import { DocumentCache } from '../../document-cache.js';
+describe('Archive Path Generation with /archived/docs/ prefix', () => {
+    let cache;
+    let manager;
+    let tempDir;
+    let testDocsRoot;
+    beforeEach(async () => {
+        // Create temporary directory for test files
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'archive-path-test-'));
+        testDocsRoot = tempDir;
+        // Configure environment
+        process.env['MCP_WORKSPACE_PATH'] = tempDir;
+        cache = new DocumentCache(testDocsRoot);
+        // Explicitly pass archivedBasePath to ensure it uses test directory
+        const archivedBasePath = path.join(testDocsRoot, 'archived');
+        manager = new DocumentManager(testDocsRoot, cache, undefined, archivedBasePath);
+    });
+    afterEach(async () => {
+        await cache.destroy();
+        // Clean up temporary directory
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore if directory doesn't exist
+        }
+    });
+    describe('Simple root-level document paths', () => {
+        it('should archive /readme.md to /archived/docs/readme.md', async () => {
+            // Create test document WITHOUT /docs/ prefix (as it's in workspace root)
+            const absPath = path.join(testDocsRoot, 'readme.md');
+            await fs.writeFile(absPath, '# README\n\nTest content.', 'utf8');
+            // Archive the document
+            const result = await manager.archiveDocument('/readme.md');
+            // Verify archive path includes /archived/docs/ prefix (now absolute)
+            const expectedArchivePath = path.join(testDocsRoot, 'archived/docs/readme.md');
+            expect(result.archivePath).toBe(expectedArchivePath);
+            // Verify file exists at correct location
+            await expect(fs.access(expectedArchivePath)).resolves.not.toThrow();
+            // Verify audit file exists
+            const auditPath = path.join(testDocsRoot, 'archived/docs/readme.md.audit');
+            await expect(fs.access(auditPath)).resolves.not.toThrow();
+        });
+    });
+    describe('Single-level namespace paths', () => {
+        it('should archive /api/auth.md to /archived/docs/api/auth.md', async () => {
+            // Create test document in api namespace (workspace root, not under docs/)
+            await fs.mkdir(path.join(testDocsRoot, 'api'), { recursive: true });
+            const absPath = path.join(testDocsRoot, 'api/auth.md');
+            await fs.writeFile(absPath, '# Authentication\n\nAuth docs.', 'utf8');
+            // Archive the document
+            const result = await manager.archiveDocument('/api/auth.md');
+            // Verify archive path includes /archived/docs/ prefix and preserves namespace (now absolute)
+            const expectedArchivePath = path.join(testDocsRoot, 'archived/docs/api/auth.md');
+            expect(result.archivePath).toBe(expectedArchivePath);
+            // Verify file exists at correct location
+            await expect(fs.access(expectedArchivePath)).resolves.not.toThrow();
+            // Verify audit file exists
+            const auditPath = path.join(testDocsRoot, 'archived/docs/api/auth.md.audit');
+            await expect(fs.access(auditPath)).resolves.not.toThrow();
+        });
+    });
+    describe('Multi-level nested namespace paths', () => {
+        it('should archive /api/v2/endpoints/users.md to /archived/docs/api/v2/endpoints/users.md', async () => {
+            // Create test document in nested namespace
+            await fs.mkdir(path.join(testDocsRoot, 'api/v2/endpoints'), { recursive: true });
+            const absPath = path.join(testDocsRoot, 'api/v2/endpoints/users.md');
+            await fs.writeFile(absPath, '# Users API\n\nUser endpoints.', 'utf8');
+            // Archive the document
+            const result = await manager.archiveDocument('/api/v2/endpoints/users.md');
+            // Verify archive path includes /archived/docs/ prefix and preserves full namespace (now absolute)
+            const expectedArchivePath = path.join(testDocsRoot, 'archived/docs/api/v2/endpoints/users.md');
+            expect(result.archivePath).toBe(expectedArchivePath);
+            // Verify file exists at correct location
+            await expect(fs.access(expectedArchivePath)).resolves.not.toThrow();
+            // Verify audit file exists
+            const auditPath = path.join(testDocsRoot, 'archived/docs/api/v2/endpoints/users.md.audit');
+            await expect(fs.access(auditPath)).resolves.not.toThrow();
+        });
+    });
+    describe('Duplicate handling with /docs/ prefix', () => {
+        it('should handle duplicate archives with counter suffix', async () => {
+            // Create test document in api namespace
+            await fs.mkdir(path.join(testDocsRoot, 'api'), { recursive: true });
+            const absPath = path.join(testDocsRoot, 'api/test.md');
+            await fs.writeFile(absPath, '# Test 1\n\nFirst version.', 'utf8');
+            // First archive
+            const result1 = await manager.archiveDocument('/api/test.md');
+            const expectedArchivePath1 = path.join(testDocsRoot, 'archived/docs/api/test.md');
+            expect(result1.archivePath).toBe(expectedArchivePath1);
+            // Create same document again
+            await fs.writeFile(absPath, '# Test 2\n\nSecond version.', 'utf8');
+            // Second archive - should get counter suffix
+            const result2 = await manager.archiveDocument('/api/test.md');
+            const expectedArchivePath2 = path.join(testDocsRoot, 'archived/docs/api/test_1.md');
+            expect(result2.archivePath).toBe(expectedArchivePath2);
+            // Verify both files exist
+            const archivePath1 = path.join(testDocsRoot, 'archived/docs/api/test.md');
+            const archivePath2 = path.join(testDocsRoot, 'archived/docs/api/test_1.md');
+            await expect(fs.access(archivePath1)).resolves.not.toThrow();
+            await expect(fs.access(archivePath2)).resolves.not.toThrow();
+        });
+    });
+    describe('Audit trail verification', () => {
+        it('should create audit file with correct original path reference', async () => {
+            // Create test document in api namespace
+            await fs.mkdir(path.join(testDocsRoot, 'api'), { recursive: true });
+            const absPath = path.join(testDocsRoot, 'api/spec.md');
+            await fs.writeFile(absPath, '# Spec\n\nAPI specification.', 'utf8');
+            // Archive the document
+            await manager.archiveDocument('/api/spec.md');
+            // Read and verify audit file
+            const auditPath = path.join(testDocsRoot, 'archived/docs/api/spec.md.audit');
+            const auditContent = await fs.readFile(auditPath, 'utf8');
+            const auditInfo = JSON.parse(auditContent);
+            expect(auditInfo['originalPath']).toBe('/api/spec.md');
+            expect(auditInfo['type']).toBe('file');
+            expect(auditInfo['archivedBy']).toBe('MCP Document Manager');
+            expect(auditInfo['archivedAt']).toBeDefined();
+        });
+    });
+    describe('Archive path format consistency', () => {
+        it('should always start archive paths with /archived/docs/', async () => {
+            const testCases = [
+                { input: '/simple.md', expectedRelative: '/archived/docs/simple.md' },
+                { input: '/guides/tutorial.md', expectedRelative: '/archived/docs/guides/tutorial.md' },
+                { input: '/specs/api/v1/auth.md', expectedRelative: '/archived/docs/specs/api/v1/auth.md' }
+            ];
+            for (const { input, expectedRelative } of testCases) {
+                // Extract path parts
+                const parts = input.split('/').filter(p => p !== '');
+                const fileName = parts[parts.length - 1] ?? '';
+                const namespace = parts.slice(0, -1).join('/');
+                // Create document in workspace (not under docs/)
+                const docPath = namespace !== '' ? `${namespace}/${fileName}` : fileName;
+                const absPath = path.join(testDocsRoot, docPath);
+                if (namespace !== '') {
+                    await fs.mkdir(path.join(testDocsRoot, namespace), { recursive: true });
+                }
+                await fs.writeFile(absPath, `# Test\n\nContent for ${input}`, 'utf8');
+                // Archive and verify (now expects absolute path)
+                const result = await manager.archiveDocument(input);
+                const expectedAbsolute = path.join(testDocsRoot, expectedRelative.slice(1)); // Remove leading /
+                expect(result.archivePath).toBe(expectedAbsolute);
+                // Clean up for next iteration
+                await fs.unlink(expectedAbsolute);
+                await fs.unlink(`${expectedAbsolute}.audit`);
+            }
+        });
+    });
+});
+//# sourceMappingURL=path-handler.archive.test.js.map

package/dist/utils/__tests__/path-handler.archive.test.js.map

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

package/dist/utils/error-formatter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Consistent error formatting utilities
+ */
+/**
+ * Formats an error for logging
+ */
+export declare function formatLogError(error: unknown, operation?: string): {
+    message: string;
+    context: Record<string, unknown>;
+};
+/**
+ * Creates a standardized error response for MCP tools
+ */
+export declare function createErrorResponse(error: unknown, operation?: string): {
+    success: false;
+    error: string;
+    code?: string | undefined;
+    context?: Record<string, unknown> | undefined;
+};
+/**
+ * Wraps an async operation with standardized error handling
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, operationName?: string): Promise<{
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+    code?: string | undefined;
+    context?: Record<string, unknown> | undefined;
+}>;
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/utils/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/error-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgCH;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAsBxH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG;IACvE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C,CAsBA;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAE,CAAC,CAOnJ"}

package/dist/utils/error-formatter.js

@@ -0,0 +1,79 @@
+/**
+ * Consistent error formatting utilities
+ */
+/**
+ * Formats an error for MCP tool responses
+ */
+function formatMCPError(error) {
+    if (error instanceof Error) {
+        const specError = error;
+        const result = {
+            error: error.message,
+        };
+        if ('code' in specError) {
+            result.code = specError.code;
+        }
+        if ('context' in specError && specError.context != null) {
+            result.context = specError.context;
+        }
+        return result;
+    }
+    return {
+        error: String(error),
+        code: 'UNKNOWN_ERROR',
+    };
+}
+/**
+ * Formats an error for logging
+ */
+export function formatLogError(error, operation) {
+    if (error instanceof Error) {
+        const specError = error;
+        return {
+            message: operation != null && operation.length > 0 ? `${operation}: ${error.message}` : error.message,
+            context: {
+                name: error.name,
+                stack: error.stack,
+                code: 'code' in specError ? specError.code : 'UNKNOWN_ERROR',
+                ...(('context' in specError && specError.context != null) ? specError.context : {}),
+            },
+        };
+    }
+    return {
+        message: operation != null && operation.length > 0 ? `${operation}: ${String(error)}` : String(error),
+        context: {
+            error: String(error),
+            code: 'UNKNOWN_ERROR',
+        },
+    };
+}
+/**
+ * Creates a standardized error response for MCP tools
+ */
+export function createErrorResponse(error, operation) {
+    const formatted = formatMCPError(error);
+    const result = {
+        success: false,
+        error: operation != null && operation.length > 0 ? `${operation}: ${formatted.error}` : formatted.error,
+    };
+    if (formatted.code != null && formatted.code.length > 0) {
+        result.code = formatted.code;
+    }
+    if (formatted.context != null) {
+        result.context = formatted.context;
+    }
+    return result;
+}
+/**
+ * Wraps an async operation with standardized error handling
+ */
+export async function withErrorHandling(operation, operationName) {
+    try {
+        const data = await operation();
+        return { success: true, data };
+    }
+    catch (error) {
+        return createErrorResponse(error, operationName);
+    }
+}
+//# sourceMappingURL=error-formatter.js.map

package/dist/utils/error-formatter.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Centralized logging utility with sanitization
+ */
+import type { Logger, ServerConfig } from '../types/index.js';
+/**
+ * Creates a logger instance based on configuration
+ */
+export declare function createLogger(config: ServerConfig): Logger;
+/**
+ * Creates a silent logger (for testing)
+ */
+export declare function createSilentLogger(): Logger;
+/**
+ * Sets the global logger instance
+ */
+export declare function setGlobalLogger(logger: Logger): void;
+/**
+ * Gets the global logger instance
+ */
+export declare function getGlobalLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuI9D;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAOzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAOD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAGxC"}

package/dist/utils/logger.js

@@ -0,0 +1,154 @@
+/**
+ * Centralized logging utility with sanitization
+ */
+import { LOG_LEVELS } from '../constants/defaults.js';
+/**
+ * Log level hierarchy for filtering
+ */
+const LOG_LEVEL_PRIORITY = {
+    [LOG_LEVELS.ERROR]: 0,
+    [LOG_LEVELS.WARN]: 1,
+    [LOG_LEVELS.INFO]: 2,
+    [LOG_LEVELS.DEBUG]: 3,
+};
+/**
+ * Sanitizes sensitive information from log context
+ */
+function sanitizeContext(context) {
+    const sanitized = {};
+    const sensitiveKeys = new Set([
+        'password',
+        'token',
+        'secret',
+        'key',
+        'auth',
+        'authorization',
+        'credential',
+        'api_key',
+        'apikey',
+    ]);
+    for (const [key, value] of Object.entries(context)) {
+        const lowerKey = key.toLowerCase();
+        if (sensitiveKeys.has(lowerKey) || lowerKey.includes('pass') || lowerKey.includes('secret')) {
+            sanitized[key] = '[REDACTED]';
+        }
+        else if (typeof value === 'string' && value.length > 500) {
+            // Truncate very long strings
+            sanitized[key] = `${value.substring(0, 497)}...`;
+        }
+        else if (value instanceof Error) {
+            sanitized[key] = {
+                name: value.name,
+                message: value.message,
+                stack: value.stack,
+            };
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Formats log message with timestamp and level
+ */
+function formatLogMessage(level, message, context) {
+    const timestamp = new Date().toISOString();
+    const levelUpper = level.toUpperCase().padEnd(5);
+    let formatted = `${timestamp} [${levelUpper}] ${message}`;
+    if (context && Object.keys(context).length > 0) {
+        const sanitized = sanitizeContext(context);
+        formatted += ` | Context: ${JSON.stringify(sanitized)}`;
+    }
+    return formatted;
+}
+/**
+ * Console logger implementation
+ */
+class ConsoleLogger {
+    levelPriority;
+    constructor(logLevel) {
+        this.levelPriority = LOG_LEVEL_PRIORITY[logLevel] ?? 2;
+    }
+    shouldLog(level) {
+        const targetPriority = LOG_LEVEL_PRIORITY[level];
+        return targetPriority !== undefined && targetPriority <= this.levelPriority;
+    }
+    error(message, context) {
+        if (this.shouldLog(LOG_LEVELS.ERROR)) {
+            const formatted = formatLogMessage(LOG_LEVELS.ERROR, message, context);
+            console.error(formatted);
+        }
+    }
+    warn(message, context) {
+        if (this.shouldLog(LOG_LEVELS.WARN)) {
+            const formatted = formatLogMessage(LOG_LEVELS.WARN, message, context);
+            console.warn(formatted);
+        }
+    }
+    info(message, context) {
+        if (this.shouldLog(LOG_LEVELS.INFO)) {
+            const formatted = formatLogMessage(LOG_LEVELS.INFO, message, context);
+            // Use console.error for info level logging to comply with ESLint rules
+            console.error(formatted);
+        }
+    }
+    debug(message, context) {
+        if (this.shouldLog(LOG_LEVELS.DEBUG)) {
+            const formatted = formatLogMessage(LOG_LEVELS.DEBUG, message, context);
+            // Use console.error for debug level logging to comply with ESLint rules
+            console.error(formatted);
+        }
+    }
+}
+/**
+ * Silent logger for testing (logs nothing)
+ */
+class SilentLogger {
+    error() {
+        // Silent
+    }
+    warn() {
+        // Silent
+    }
+    info() {
+        // Silent
+    }
+    debug() {
+        // Silent
+    }
+}
+/**
+ * Creates a logger instance based on configuration
+ */
+export function createLogger(config) {
+    // Use silent logger in test mode unless explicitly overridden
+    if (process.env['NODE_ENV'] === 'test' && process.env['ENABLE_TEST_LOGGING'] == null) {
+        return new SilentLogger();
+    }
+    return new ConsoleLogger(config.logLevel);
+}
+/**
+ * Creates a silent logger (for testing)
+ */
+export function createSilentLogger() {
+    return new SilentLogger();
+}
+/**
+ * Global logger instance (set by server initialization)
+ */
+let globalLogger = null;
+/**
+ * Sets the global logger instance
+ */
+export function setGlobalLogger(logger) {
+    globalLogger = logger;
+}
+/**
+ * Gets the global logger instance
+ */
+export function getGlobalLogger() {
+    globalLogger ??= new ConsoleLogger(LOG_LEVELS.INFO);
+    return globalLogger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD;;GAEG;AACH,MAAM,kBAAkB,GAAG;IACzB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;IACrB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IACpB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IACpB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;CACb,CAAC;AAEX;;GAEG;AACH,SAAS,eAAe,CAAC,OAAgC;IACvD,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;QAC5B,UAAU;QACV,OAAO;QACP,QAAQ;QACR,KAAK;QACL,MAAM;QACN,eAAe;QACf,YAAY;QACZ,SAAS;QACT,QAAQ;KACT,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAEnC,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5F,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAChC,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC3D,6BAA6B;YAC7B,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;QACnD,CAAC;aAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAClC,SAAS,CAAC,GAAG,CAAC,GAAG;gBACf,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAa,EAAE,OAAe,EAAE,OAAiC;IACzF,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEjD,IAAI,SAAS,GAAG,GAAG,SAAS,KAAK,UAAU,KAAK,OAAO,EAAE,CAAC;IAE1D,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC3C,SAAS,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,aAAa;IACA,aAAa,CAAS;IAEvC,YAAY,QAAgB;QAC1B,IAAI,CAAC,aAAa,GAAG,kBAAkB,CAAC,QAA2C,CAAC,IAAI,CAAC,CAAC;IAC5F,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAwC,CAAC,CAAC;QACpF,OAAO,cAAc,KAAK,SAAS,IAAI,cAAc,IAAI,IAAI,CAAC,aAAa,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACtE,uEAAuE;YACvE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACvE,wEAAwE;YACxE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,YAAY;IAChB,KAAK;QACH,SAAS;IACX,CAAC;IAED,IAAI;QACF,SAAS;IACX,CAAC;IAED,IAAI;QACF,SAAS;IACX,CAAC;IAED,KAAK;QACH,SAAS;IACX,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,8DAA8D;IAC9D,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,IAAI,EAAE,CAAC;QACrF,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,YAAY,KAAK,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/utils/path-handler.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Centralized path handling utilities for MCP server
+ */
+/**
+ * Path validation and normalization utilities
+ */
+export declare class PathHandler {
+    private readonly workspaceBasePath;
+    private readonly archivedBasePath;
+    constructor(workspaceBasePath: string, archivedBasePath?: string);
+    /**
+     * Normalize and validate a user-provided path
+     */
+    normalizePath(userPath: string): string;
+    /**
+     * Validate that a path is within the allowed docs directory
+     */
+    validatePath(normalizedPath: string): void;
+    /**
+     * Get absolute filesystem path from normalized path
+     */
+    getAbsolutePath(normalizedPath: string): string;
+    /**
+     * Check if a path represents a folder (ends with / or has no extension)
+     */
+    isFolder(normalizedPath: string): boolean;
+    /**
+     * Get the parent directory path
+     */
+    getParentPath(normalizedPath: string): string;
+    /**
+     * Generate unique archive path to handle duplicates
+     */
+    generateUniqueArchivePath(normalizedPath: string): Promise<string>;
+    /**
+     * Check if file exists using direct fs.access (for internal use with absolute paths)
+     */
+    private checkFileExists;
+    /**
+     * Normalize and validate path in one call
+     */
+    processUserPath(userPath: string): string;
+    /**
+     * Get workspace base path
+     */
+    getWorkspaceBasePath(): string;
+    /**
+     * Get archived base path (if configured)
+     */
+    getArchivedBasePath(): string | undefined;
+}
+//# sourceMappingURL=path-handler.d.ts.map

package/dist/utils/path-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-handler.d.ts","sourceRoot":"","sources":["../../src/utils/path-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;gBAE1C,iBAAiB,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAKhE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IA6BvC;;OAEG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAU1C;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAK/C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAK7C;;OAEG;IACG,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBxE;;OAEG;YACW,eAAe;IAS7B;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAMzC;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,mBAAmB,IAAI,MAAM,GAAG,SAAS;CAG1C"}