@j0hanz/filesystem-context-mcp 1.0.10 → 1.2.0

package/dist/lib/errors.js

@@ -1,13 +1,10 @@
-import { ErrorCode, } from '../config/types.js';
-// Re-export ErrorCode from centralized location
+import { ErrorCode } from '../config/types.js';
 export { ErrorCode };
-// Type guard for Node.js ErrnoException
 export function isNodeError(error) {
     return (error instanceof Error &&
         'code' in error &&
         typeof error.code === 'string');
 }
-// Mapping of Node.js error codes to McpError codes
 export const NODE_ERROR_CODE_MAP = {
     ENOENT: ErrorCode.E_NOT_FOUND,
     EACCES: ErrorCode.E_PERMISSION_DENIED,
@@ -24,7 +21,6 @@ export const NODE_ERROR_CODE_MAP = {
     EEXIST: ErrorCode.E_INVALID_INPUT,
     EINVAL: ErrorCode.E_INVALID_INPUT,
 };
-// Custom error class for MCP operations
 export class McpError extends Error {
     code;
     path;
@@ -35,151 +31,50 @@ export class McpError extends Error {
         this.path = path;
         this.details = details;
         this.name = 'McpError';
-        // Ensure proper prototype chain for instanceof checks
         Object.setPrototypeOf(this, McpError.prototype);
     }
-    // Create McpError from existing error
     static fromError(code, message, originalError, path, details) {
         const mcpError = new McpError(code, message, path, details, originalError);
-        // Preserve stack trace if available
         if (originalError instanceof Error && originalError.stack) {
             mcpError.stack = `${String(mcpError.stack)}\nCaused by: ${originalError.stack}`;
         }
         return mcpError;
     }
 }
-// Error code to suggestion mapping
 const ERROR_SUGGESTIONS = {
     [ErrorCode.E_ACCESS_DENIED]: 'Check that the path is within an allowed directory. Use list_allowed_directories to see available paths.',
     [ErrorCode.E_NOT_FOUND]: 'Verify the path exists. Use list_directory to explore available files and directories.',
     [ErrorCode.E_NOT_FILE]: 'The path points to a directory or other non-file. Use list_directory to explore its contents.',
     [ErrorCode.E_NOT_DIRECTORY]: 'The path points to a file, not a directory. Use read_file to read file contents.',
     [ErrorCode.E_TOO_LARGE]: 'The file exceeds the size limit. Use head or tail parameters to read partial content, or increase maxSize.',
-    [ErrorCode.E_BINARY_FILE]: 'This appears to be a binary file. Use read_media_file for images/audio, or set skipBinary=false to include.',
     [ErrorCode.E_TIMEOUT]: 'The operation timed out. Try with a smaller scope, fewer files, or increase timeoutMs.',
     [ErrorCode.E_INVALID_PATTERN]: 'The glob or regex pattern is invalid. Check syntax and escape special characters.',
     [ErrorCode.E_INVALID_INPUT]: 'One or more input parameters are invalid. Check the tool documentation for correct usage.',
     [ErrorCode.E_PERMISSION_DENIED]: 'Permission denied by the operating system. Check file permissions.',
     [ErrorCode.E_SYMLINK_NOT_ALLOWED]: 'Symbolic links that escape allowed directories are not permitted for security reasons.',
-    [ErrorCode.E_PATH_TRAVERSAL]: 'Path traversal attempts (../) that escape allowed directories are not permitted.',
     [ErrorCode.E_UNKNOWN]: 'An unexpected error occurred. Check the error message for details.',
 };
-// Classify an unknown error into a standardized ErrorCode
 export function classifyError(error) {
-    // 1. Direct McpError classification
     if (error instanceof McpError) {
         return error.code;
     }
-    // 2. Node.js ErrnoException code mapping
     if (isNodeError(error) && error.code) {
         const mapped = NODE_ERROR_CODE_MAP[error.code];
         if (mapped)
             return mapped;
     }
-    // 3. Common case optimization: check for ENOENT in message
-    const message = error instanceof Error ? error.message : String(error);
-    if (message.toLowerCase().includes('enoent')) {
-        return validateErrorCode(ErrorCode.E_NOT_FOUND);
-    }
-    // 4. Message pattern matching (fallback for non-Node errors)
-    return classifyByMessage(error);
-}
-// Assertion function for exhaustive checks
-function assertNever(value) {
-    throw new Error(`Unhandled discriminated union member: ${JSON.stringify(value)}`);
-}
-// Validate ErrorCode exhaustiveness at compile time
-function validateErrorCode(code) {
-    switch (code) {
-        case ErrorCode.E_ACCESS_DENIED:
-        case ErrorCode.E_NOT_FOUND:
-        case ErrorCode.E_NOT_FILE:
-        case ErrorCode.E_NOT_DIRECTORY:
-        case ErrorCode.E_TOO_LARGE:
-        case ErrorCode.E_BINARY_FILE:
-        case ErrorCode.E_TIMEOUT:
-        case ErrorCode.E_INVALID_PATTERN:
-        case ErrorCode.E_INVALID_INPUT:
-        case ErrorCode.E_PERMISSION_DENIED:
-        case ErrorCode.E_SYMLINK_NOT_ALLOWED:
-        case ErrorCode.E_PATH_TRAVERSAL:
-        case ErrorCode.E_UNKNOWN:
-            return code;
-        default:
-            return assertNever(code);
-    }
-}
-function classifyByMessage(error) {
     const message = error instanceof Error ? error.message : String(error);
     const lowerMessage = message.toLowerCase();
-    // Access/security related
-    if (lowerMessage.includes('not within allowed') ||
-        lowerMessage.includes('access denied') ||
-        lowerMessage.includes('outside allowed')) {
-        return validateErrorCode(ErrorCode.E_ACCESS_DENIED);
-    }
-    // Not found (path-related patterns)
-    if ((lowerMessage.includes('path') ||
-        lowerMessage.includes('file') ||
-        lowerMessage.includes('directory')) &&
-        (lowerMessage.includes('not found') ||
-            lowerMessage.includes('does not exist'))) {
-        return validateErrorCode(ErrorCode.E_NOT_FOUND);
-    }
-    // Type mismatches
-    if (lowerMessage.includes('not a file') ||
-        lowerMessage.includes('is a directory')) {
-        return validateErrorCode(ErrorCode.E_NOT_FILE);
-    }
-    if (lowerMessage.includes('not a directory')) {
-        return validateErrorCode(ErrorCode.E_NOT_DIRECTORY);
-    }
-    // Size limits
-    if (lowerMessage.includes('too large') || lowerMessage.includes('exceeds')) {
-        return validateErrorCode(ErrorCode.E_TOO_LARGE);
-    }
-    // Binary file
-    if (lowerMessage.includes('binary')) {
-        return validateErrorCode(ErrorCode.E_BINARY_FILE);
-    }
-    // Timeout
-    if (lowerMessage.includes('timeout') || lowerMessage.includes('timed out')) {
-        return validateErrorCode(ErrorCode.E_TIMEOUT);
-    }
-    // Invalid pattern
-    if (lowerMessage.includes('invalid') && lowerMessage.includes('pattern')) {
-        return validateErrorCode(ErrorCode.E_INVALID_PATTERN);
-    }
-    if (lowerMessage.includes('regex') || lowerMessage.includes('regexp')) {
-        return validateErrorCode(ErrorCode.E_INVALID_PATTERN);
-    }
-    // Invalid input
-    if (lowerMessage.includes('invalid') ||
-        lowerMessage.includes('cannot specify')) {
-        return validateErrorCode(ErrorCode.E_INVALID_INPUT);
-    }
-    // Permission (when no error code available)
-    if (lowerMessage.includes('permission denied') ||
-        lowerMessage.includes('permission')) {
-        return validateErrorCode(ErrorCode.E_PERMISSION_DENIED);
-    }
-    // Symlink
-    if (lowerMessage.includes('symlink')) {
-        return validateErrorCode(ErrorCode.E_SYMLINK_NOT_ALLOWED);
-    }
-    // Path traversal
-    if (lowerMessage.includes('traversal')) {
-        return validateErrorCode(ErrorCode.E_PATH_TRAVERSAL);
+    if (lowerMessage.includes('enoent')) {
+        return ErrorCode.E_NOT_FOUND;
     }
-    return validateErrorCode(ErrorCode.E_UNKNOWN);
+    return ErrorCode.E_UNKNOWN;
 }
-// Create detailed error with suggestions
 export function createDetailedError(error, path, additionalDetails) {
     const message = error instanceof Error ? error.message : String(error);
     const code = classifyError(error);
     const suggestion = ERROR_SUGGESTIONS[code];
     const effectivePath = path ?? (error instanceof McpError ? error.path : undefined);
-    // Merge details from McpError and additionalDetails
     const mcpDetails = error instanceof McpError ? error.details : undefined;
     const mergedDetails = {
         ...mcpDetails,
@@ -194,7 +89,6 @@ export function createDetailedError(error, path, additionalDetails) {
         details: hasDetails ? mergedDetails : undefined,
     };
 }
-// Format error for display
 export function formatDetailedError(error) {
     const lines = [`Error [${error.code}]: ${error.message}`];
     if (error.path) {
@@ -208,10 +102,8 @@ export function formatDetailedError(error) {
 export function getSuggestion(code) {
     return ERROR_SUGGESTIONS[code];
 }
-// Create MCP-compatible error response
 export function createErrorResponse(error, defaultCode, path) {
     const detailed = createDetailedError(error, path);
-    // Use more specific code if classified, otherwise use default
     const finalCode = detailed.code === ErrorCode.E_UNKNOWN ? defaultCode : detailed.code;
     detailed.code = finalCode;
     return {

package/dist/lib/errors.js.map

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

package/dist/lib/file-operations/analyze-directory.d.ts

@@ -0,0 +1,8 @@
+import type { AnalyzeDirectoryResult } from '../../config/types.js';
+export declare function analyzeDirectory(dirPath: string, options?: {
+    maxDepth?: number;
+    topN?: number;
+    excludePatterns?: string[];
+    includeHidden?: boolean;
+}): Promise<AnalyzeDirectoryResult>;
+//# sourceMappingURL=analyze-directory.d.ts.map

package/dist/lib/file-operations/analyze-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-directory.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/analyze-directory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,uBAAuB,CAAC;AAuK/B,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,OAAO,CAAC,sBAAsB,CAAC,CAiCjC"}

package/dist/lib/file-operations/analyze-directory.js

@@ -0,0 +1,117 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { DEFAULT_MAX_DEPTH, DEFAULT_TOP_N, DIR_TRAVERSAL_CONCURRENCY, } from '../constants.js';
+import { runWorkQueue } from '../fs-helpers.js';
+import { validateExistingPath, validateExistingPathDetailed, } from '../path-validation.js';
+import { classifyAccessError, createExcludeMatcher, forEachDirectoryEntry, } from './directory-iteration.js';
+function initAnalysisState() {
+    return {
+        totalFiles: 0,
+        totalDirectories: 0,
+        totalSize: 0,
+        currentMaxDepth: 0,
+        skippedInaccessible: 0,
+        symlinksNotFollowed: 0,
+        fileTypes: {},
+        largestFiles: [],
+        recentlyModified: [],
+    };
+}
+function pushTopN(arr, item, compare, maxLen) {
+    if (maxLen <= 0)
+        return;
+    arr.push(item);
+    if (arr.length <= maxLen)
+        return;
+    arr.sort(compare);
+    arr.length = maxLen;
+}
+function updateFileType(state, filename) {
+    const ext = path.extname(filename).toLowerCase() || '(no extension)';
+    state.fileTypes[ext] = (state.fileTypes[ext] ?? 0) + 1;
+}
+function updateFileStats(state, filePath, stats, topN) {
+    state.totalFiles++;
+    state.totalSize += stats.size;
+    updateFileType(state, filePath);
+    pushTopN(state.largestFiles, { path: filePath, size: stats.size }, (a, b) => b.size - a.size, topN);
+    pushTopN(state.recentlyModified, { path: filePath, modified: stats.mtime }, (a, b) => b.modified.getTime() - a.modified.getTime(), topN);
+}
+async function handleEntry(params, enqueue, state, options) {
+    if (params.depth > options.maxDepth)
+        return;
+    state.currentMaxDepth = Math.max(state.currentMaxDepth, params.depth);
+    await forEachDirectoryEntry(params.currentPath, options.basePath, {
+        includeHidden: options.includeHidden,
+        shouldExclude: options.shouldExclude,
+        onInaccessible: () => {
+            state.skippedInaccessible++;
+        },
+    }, async ({ item, fullPath }) => {
+        try {
+            const validated = await validateExistingPathDetailed(fullPath);
+            if (validated.isSymlink || item.isSymbolicLink()) {
+                state.symlinksNotFollowed++;
+                return;
+            }
+            const stats = await fs.stat(validated.resolvedPath);
+            if (stats.isDirectory()) {
+                state.totalDirectories++;
+                if (params.depth + 1 <= options.maxDepth) {
+                    enqueue({
+                        currentPath: validated.resolvedPath,
+                        depth: params.depth + 1,
+                    });
+                }
+                return;
+            }
+            if (stats.isFile()) {
+                updateFileStats(state, validated.resolvedPath, stats, options.topN);
+            }
+        }
+        catch (error) {
+            if (classifyAccessError(error) === 'symlink') {
+                state.symlinksNotFollowed++;
+            }
+            else {
+                state.skippedInaccessible++;
+            }
+        }
+    });
+}
+function finalizeAnalysis(state, basePath) {
+    state.largestFiles.sort((a, b) => b.size - a.size);
+    state.recentlyModified.sort((a, b) => b.modified.getTime() - a.modified.getTime());
+    return {
+        path: basePath,
+        totalFiles: state.totalFiles,
+        totalDirectories: state.totalDirectories,
+        totalSize: state.totalSize,
+        fileTypes: state.fileTypes,
+        largestFiles: state.largestFiles,
+        recentlyModified: state.recentlyModified,
+        maxDepth: state.currentMaxDepth,
+    };
+}
+export async function analyzeDirectory(dirPath, options = {}) {
+    const { maxDepth = DEFAULT_MAX_DEPTH, topN = DEFAULT_TOP_N, excludePatterns = [], includeHidden = false, } = options;
+    const basePath = await validateExistingPath(dirPath);
+    const state = initAnalysisState();
+    const shouldExclude = createExcludeMatcher(excludePatterns);
+    await runWorkQueue([{ currentPath: basePath, depth: 0 }], async (params, enqueue) => handleEntry(params, enqueue, state, {
+        basePath,
+        maxDepth,
+        topN,
+        includeHidden,
+        shouldExclude,
+    }), DIR_TRAVERSAL_CONCURRENCY);
+    return {
+        analysis: finalizeAnalysis(state, basePath),
+        summary: {
+            truncated: false,
+            skippedInaccessible: state.skippedInaccessible,
+            symlinksNotFollowed: state.symlinksNotFollowed,
+        },
+    };
+}
+//# sourceMappingURL=analyze-directory.js.map

package/dist/lib/file-operations/analyze-directory.js.map

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

package/dist/lib/file-operations/directory-items.d.ts

@@ -0,0 +1,20 @@
+import type { Dirent } from 'node:fs';
+import type { DirectoryEntry } from '../../config/types.js';
+export interface DirectoryItemResult {
+    entry: DirectoryEntry;
+    enqueueDir?: {
+        currentPath: string;
+        depth: number;
+    };
+    skippedInaccessible?: boolean;
+    symlinkNotFollowed?: boolean;
+}
+interface DirectoryItemOptions {
+    includeSymlinkTargets: boolean;
+    recursive: boolean;
+    depth: number;
+    maxDepth: number;
+}
+export declare function buildDirectoryItemResult(item: Dirent, currentPath: string, basePath: string, options: DirectoryItemOptions): Promise<DirectoryItemResult>;
+export {};
+//# sourceMappingURL=directory-items.d.ts.map

package/dist/lib/file-operations/directory-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-items.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-items.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,SAAS,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,uBAAuB,CAAC;AAItE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,UAAU,oBAAoB;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4GD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAkB9B"}

package/dist/lib/file-operations/directory-items.js

@@ -0,0 +1,85 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getFileType } from '../fs-helpers.js';
+import { validateExistingPath } from '../path-validation.js';
+function buildEntryBase(item, fullPath, relativePath, type) {
+    return {
+        name: item.name,
+        path: fullPath,
+        relativePath,
+        type,
+    };
+}
+function resolveEntryType(item, stats) {
+    if (item.isDirectory())
+        return 'directory';
+    if (item.isFile())
+        return 'file';
+    return getFileType(stats);
+}
+async function buildSymlinkResult(item, fullPath, relativePath, includeSymlinkTargets) {
+    const stats = await fs.lstat(fullPath);
+    let symlinkTarget;
+    if (includeSymlinkTargets) {
+        try {
+            symlinkTarget = await fs.readlink(fullPath);
+        }
+        catch {
+            symlinkTarget = undefined;
+        }
+    }
+    const entry = {
+        name: item.name,
+        path: fullPath,
+        relativePath,
+        type: 'symlink',
+        size: stats.size,
+        modified: stats.mtime,
+        symlinkTarget,
+    };
+    return { entry, symlinkNotFollowed: true };
+}
+async function buildEnqueueDir(fullPath, depth, maxDepth, recursive) {
+    if (!recursive || depth + 1 > maxDepth)
+        return undefined;
+    return {
+        currentPath: await validateExistingPath(fullPath),
+        depth: depth + 1,
+    };
+}
+async function buildRegularResult(item, fullPath, relativePath, options) {
+    const stats = await fs.stat(fullPath);
+    const type = resolveEntryType(item, stats);
+    const entry = {
+        ...buildEntryBase(item, fullPath, relativePath, type),
+        size: type === 'file' ? stats.size : undefined,
+        modified: stats.mtime,
+    };
+    const enqueueDir = await buildEnqueueDir(fullPath, options.depth, options.maxDepth, options.recursive);
+    return { entry, enqueueDir };
+}
+function buildFallbackEntry(item, fullPath, relativePath) {
+    const type = item.isDirectory()
+        ? 'directory'
+        : item.isFile()
+            ? 'file'
+            : 'other';
+    return {
+        entry: buildEntryBase(item, fullPath, relativePath, type),
+        skippedInaccessible: true,
+    };
+}
+export async function buildDirectoryItemResult(item, currentPath, basePath, options) {
+    const fullPath = path.join(currentPath, item.name);
+    const relativePath = path.relative(basePath, fullPath) || item.name;
+    try {
+        if (item.isSymbolicLink()) {
+            return await buildSymlinkResult(item, fullPath, relativePath, options.includeSymlinkTargets);
+        }
+        return await buildRegularResult(item, fullPath, relativePath, options);
+    }
+    catch {
+        return buildFallbackEntry(item, fullPath, relativePath);
+    }
+}
+//# sourceMappingURL=directory-items.js.map

package/dist/lib/file-operations/directory-items.js.map

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

package/dist/lib/file-operations/directory-iteration.d.ts

@@ -0,0 +1,17 @@
+import type { Dirent } from 'node:fs';
+export interface DirectoryIterationEntry {
+    item: Dirent;
+    name: string;
+    fullPath: string;
+    relativePath: string;
+}
+export interface DirectoryIterationOptions {
+    includeHidden: boolean;
+    shouldExclude: (name: string, relativePath: string) => boolean;
+    onInaccessible: () => void;
+    shouldStop?: () => boolean;
+}
+export declare function createExcludeMatcher(excludePatterns: string[]): (name: string, relativePath: string) => boolean;
+export declare function classifyAccessError(error: unknown): 'symlink' | 'inaccessible';
+export declare function forEachDirectoryEntry(currentPath: string, basePath: string, options: DirectoryIterationOptions, handler: (entry: DirectoryIterationEntry) => Promise<void>): Promise<void>;
+//# sourceMappingURL=directory-iteration.d.ts.map

package/dist/lib/file-operations/directory-iteration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-iteration.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-iteration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAOtC,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/D,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC5B;AAQD,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EAAE,GACxB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAejD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,SAAS,GAAG,cAAc,CAU5B;AAcD,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/lib/file-operations/directory-iteration.js

@@ -0,0 +1,55 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { Minimatch } from 'minimatch';
+import { ErrorCode, McpError } from '../errors.js';
+import { isHidden } from '../fs-helpers.js';
+const MATCHER_OPTIONS = {
+    dot: true,
+    nocase: process.platform === 'win32',
+    windowsPathsNoEscape: true,
+};
+export function createExcludeMatcher(excludePatterns) {
+    if (excludePatterns.length === 0) {
+        return () => false;
+    }
+    const matchers = excludePatterns.map((pattern) => new Minimatch(pattern, MATCHER_OPTIONS));
+    return (name, relativePath) => {
+        const normalizedRelativePath = relativePath.replace(/\\/g, '/');
+        return matchers.some((matcher) => matcher.match(name) || matcher.match(normalizedRelativePath));
+    };
+}
+export function classifyAccessError(error) {
+    if (error instanceof McpError &&
+        (error.code === ErrorCode.E_ACCESS_DENIED ||
+            error.code === ErrorCode.E_SYMLINK_NOT_ALLOWED)) {
+        return 'symlink';
+    }
+    return 'inaccessible';
+}
+async function readDirectoryEntries(currentPath, onInaccessible) {
+    try {
+        return await fs.readdir(currentPath, { withFileTypes: true });
+    }
+    catch {
+        onInaccessible();
+        return null;
+    }
+}
+export async function forEachDirectoryEntry(currentPath, basePath, options, handler) {
+    const items = await readDirectoryEntries(currentPath, options.onInaccessible);
+    if (!items)
+        return;
+    for (const item of items) {
+        if (options.shouldStop?.())
+            break;
+        const { name } = item;
+        if (!options.includeHidden && isHidden(name))
+            continue;
+        const fullPath = path.join(currentPath, name);
+        const relativePath = path.relative(basePath, fullPath);
+        if (options.shouldExclude(name, relativePath))
+            continue;
+        await handler({ item, name, fullPath, relativePath });
+    }
+}
+//# sourceMappingURL=directory-iteration.js.map

package/dist/lib/file-operations/directory-iteration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-iteration.js","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-iteration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAgB5C,MAAM,eAAe,GAAG;IACtB,GAAG,EAAE,IAAI;IACT,MAAM,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;IACpC,oBAAoB,EAAE,IAAI;CAClB,CAAC;AAEX,MAAM,UAAU,oBAAoB,CAClC,eAAyB;IAEzB,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAClC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,CACrD,CAAC;IAEF,OAAO,CAAC,IAAY,EAAE,YAAoB,EAAW,EAAE;QACrD,MAAM,sBAAsB,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAC1E,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,IACE,KAAK,YAAY,QAAQ;QACzB,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,eAAe;YACvC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,qBAAqB,CAAC,EACjD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,WAAmB,EACnB,cAA0B;IAE1B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,cAAc,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,QAAgB,EAChB,OAAkC,EAClC,OAA0D;IAE1D,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9E,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE;YAAE,MAAM;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAEvD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC;YAAE,SAAS;QAExD,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/lib/file-operations/directory-tree.d.ts

@@ -0,0 +1,9 @@
+import type { DirectoryTreeResult } from '../../config/types.js';
+export declare function getDirectoryTree(dirPath: string, options?: {
+    maxDepth?: number;
+    excludePatterns?: string[];
+    includeHidden?: boolean;
+    includeSize?: boolean;
+    maxFiles?: number;
+}): Promise<DirectoryTreeResult>;
+//# sourceMappingURL=directory-tree.d.ts.map

package/dist/lib/file-operations/directory-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-tree.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-tree.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAa,MAAM,uBAAuB,CAAC;AAyO5E,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,OAAO,CAAC,mBAAmB,CAAC,CAuD9B"}