@j0hanz/filesystem-context-mcp 1.1.0 → 1.2.1

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

@@ -0,0 +1,175 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { DEFAULT_TREE_DEPTH, DEFAULT_TREE_MAX_FILES, DIR_TRAVERSAL_CONCURRENCY, } from '../constants.js';
+import { ErrorCode, McpError } from '../errors.js';
+import { runWorkQueue } from '../fs-helpers.js';
+import { validateExistingPath, validateExistingPathDetailed, } from '../path-validation.js';
+import { classifyAccessError, createExcludeMatcher, forEachDirectoryEntry, } from './directory-helpers.js';
+function initTreeState(basePath) {
+    return {
+        totalFiles: 0,
+        totalDirectories: 0,
+        maxDepthReached: 0,
+        skippedInaccessible: 0,
+        symlinksNotFollowed: 0,
+        truncated: false,
+        collectedEntries: [],
+        directoriesFound: new Set([basePath]),
+    };
+}
+function hitMaxFiles(state, maxFiles) {
+    if (state.totalFiles < maxFiles)
+        return false;
+    state.truncated = true;
+    return true;
+}
+function markTruncated(state) {
+    state.truncated = true;
+}
+function addFileEntry(state, params, name, size) {
+    state.totalFiles++;
+    state.collectedEntries.push({
+        parentPath: params.currentPath,
+        name,
+        type: 'file',
+        size,
+        depth: params.depth,
+    });
+}
+function addDirectoryEntry(state, params, name, resolvedPath, enqueue, maxDepth) {
+    state.totalDirectories++;
+    state.directoriesFound.add(resolvedPath);
+    state.collectedEntries.push({
+        parentPath: params.currentPath,
+        name,
+        type: 'directory',
+        depth: params.depth,
+    });
+    if (params.depth + 1 <= maxDepth) {
+        enqueue({ currentPath: resolvedPath, depth: params.depth + 1 });
+    }
+    else {
+        markTruncated(state);
+    }
+}
+async function handleTreeNode(params, enqueue, state, options) {
+    if (hitMaxFiles(state, options.maxFiles))
+        return;
+    if (params.depth > options.maxDepth) {
+        markTruncated(state);
+        return;
+    }
+    state.maxDepthReached = Math.max(state.maxDepthReached, params.depth);
+    await forEachDirectoryEntry(params.currentPath, options.basePath, {
+        includeHidden: options.includeHidden,
+        shouldExclude: options.shouldExclude,
+        onInaccessible: () => {
+            state.skippedInaccessible++;
+        },
+        shouldStop: () => hitMaxFiles(state, options.maxFiles),
+    }, async ({ item, name, fullPath }) => {
+        if (item.isSymbolicLink()) {
+            state.symlinksNotFollowed++;
+            return;
+        }
+        try {
+            const { resolvedPath, isSymlink } = await validateExistingPathDetailed(fullPath);
+            if (isSymlink) {
+                state.symlinksNotFollowed++;
+                return;
+            }
+            const stats = await fs.stat(resolvedPath);
+            if (stats.isFile()) {
+                addFileEntry(state, params, name, options.includeSize ? stats.size : undefined);
+                return;
+            }
+            if (stats.isDirectory()) {
+                addDirectoryEntry(state, params, name, resolvedPath, enqueue, options.maxDepth);
+            }
+        }
+        catch (error) {
+            if (classifyAccessError(error) === 'symlink') {
+                state.symlinksNotFollowed++;
+            }
+            else {
+                state.skippedInaccessible++;
+            }
+        }
+    });
+}
+function buildChildrenByParent(directoriesFound, collectedEntries) {
+    const childrenByParent = new Map();
+    for (const dirPath of directoriesFound) {
+        childrenByParent.set(dirPath, []);
+    }
+    for (const entry of collectedEntries) {
+        const treeEntry = {
+            name: entry.name,
+            type: entry.type,
+        };
+        if (entry.type === 'file' && entry.size !== undefined) {
+            treeEntry.size = entry.size;
+        }
+        if (entry.type === 'directory') {
+            const fullPath = path.join(entry.parentPath, entry.name);
+            treeEntry.children = childrenByParent.get(fullPath) ?? [];
+        }
+        const siblings = childrenByParent.get(entry.parentPath);
+        if (siblings) {
+            siblings.push(treeEntry);
+        }
+    }
+    return childrenByParent;
+}
+function sortTreeChildren(childrenByParent) {
+    for (const children of childrenByParent.values()) {
+        children.sort((a, b) => {
+            if (a.type !== b.type) {
+                return a.type === 'directory' ? -1 : 1;
+            }
+            return a.name.localeCompare(b.name);
+        });
+    }
+}
+function buildTree(rootPath, childrenByParent) {
+    const rootName = path.basename(rootPath);
+    return {
+        name: rootName || rootPath,
+        type: 'directory',
+        children: childrenByParent.get(rootPath) ?? [],
+    };
+}
+export async function getDirectoryTree(dirPath, options = {}) {
+    const { maxDepth = DEFAULT_TREE_DEPTH, excludePatterns = [], includeHidden = false, includeSize = false, maxFiles, } = options;
+    const basePath = await validateExistingPath(dirPath);
+    const rootStats = await fs.stat(basePath);
+    if (!rootStats.isDirectory()) {
+        throw new McpError(ErrorCode.E_NOT_DIRECTORY, `Not a directory: ${dirPath}`, dirPath);
+    }
+    const state = initTreeState(basePath);
+    const shouldExclude = createExcludeMatcher(excludePatterns);
+    const effectiveMaxFiles = maxFiles ?? DEFAULT_TREE_MAX_FILES;
+    await runWorkQueue([{ currentPath: basePath, depth: 0 }], async (params, enqueue) => handleTreeNode(params, enqueue, state, {
+        basePath,
+        maxDepth,
+        includeHidden,
+        includeSize,
+        maxFiles: effectiveMaxFiles,
+        shouldExclude,
+    }), DIR_TRAVERSAL_CONCURRENCY);
+    const childrenByParent = buildChildrenByParent(state.directoriesFound, state.collectedEntries);
+    sortTreeChildren(childrenByParent);
+    const tree = buildTree(basePath, childrenByParent);
+    return {
+        tree,
+        summary: {
+            totalFiles: state.totalFiles,
+            totalDirectories: state.totalDirectories,
+            maxDepthReached: state.maxDepthReached,
+            truncated: state.truncated,
+            skippedInaccessible: state.skippedInaccessible,
+            symlinksNotFollowed: state.symlinksNotFollowed,
+        },
+    };
+}
+//# sourceMappingURL=directory-tree.js.map

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

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

package/dist/lib/file-operations/file-info.d.ts

@@ -0,0 +1,3 @@
+import type { FileInfo } from '../../config/types.js';
+export declare function getFileInfo(filePath: string): Promise<FileInfo>;
+//# sourceMappingURL=file-info.d.ts.map

package/dist/lib/file-operations/file-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-info.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/file-info.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAqCtD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0BrE"}

package/dist/lib/file-operations/file-info.js

@@ -0,0 +1,56 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getMimeType } from '../constants.js';
+import { getFileType, isHidden } from '../fs-helpers.js';
+import { validateExistingPathDetailed } from '../path-validation.js';
+const PERM_STRINGS = [
+    '---',
+    '--x',
+    '-w-',
+    '-wx',
+    'r--',
+    'r-x',
+    'rw-',
+    'rwx',
+];
+function getPermissions(mode) {
+    const ownerIndex = (mode >> 6) & 0b111;
+    const groupIndex = (mode >> 3) & 0b111;
+    const otherIndex = mode & 0b111;
+    const owner = PERM_STRINGS[ownerIndex] ?? '---';
+    const group = PERM_STRINGS[groupIndex] ?? '---';
+    const other = PERM_STRINGS[otherIndex] ?? '---';
+    return `${owner}${group}${other}`;
+}
+async function getSymlinkTarget(pathToRead) {
+    try {
+        return await fs.readlink(pathToRead);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function getFileInfo(filePath) {
+    const { requestedPath, resolvedPath, isSymlink } = await validateExistingPathDetailed(filePath);
+    const name = path.basename(requestedPath);
+    const ext = path.extname(name).toLowerCase();
+    const mimeType = ext ? getMimeType(ext) : undefined;
+    const symlinkTarget = isSymlink
+        ? await getSymlinkTarget(requestedPath)
+        : undefined;
+    const stats = await fs.stat(resolvedPath);
+    return {
+        name,
+        path: requestedPath,
+        type: isSymlink ? 'symlink' : getFileType(stats),
+        size: stats.size,
+        created: stats.birthtime,
+        modified: stats.mtime,
+        accessed: stats.atime,
+        permissions: getPermissions(stats.mode),
+        isHidden: isHidden(name),
+        mimeType,
+        symlinkTarget,
+    };
+}
+//# sourceMappingURL=file-info.js.map

package/dist/lib/file-operations/file-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-info.js","sourceRoot":"","sources":["../../../src/lib/file-operations/file-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,YAAY,GAAG;IACnB,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CAC+B,CAAC;AAEvC,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;IACvC,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;IAChC,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAChD,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IAEhD,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,UAAkB;IAElB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,GAC9C,MAAM,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAE/C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,MAAM,aAAa,GAAG,SAAS;QAC7B,CAAC,CAAC,MAAM,gBAAgB,CAAC,aAAa,CAAC;QACvC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAE1C,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC;QAChD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,SAAS;QACxB,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,WAAW,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC;QACvC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;QACxB,QAAQ;QACR,aAAa;KACd,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { ListDirectoryResult } from '../../config/types.js';
+export declare function listDirectory(dirPath: string, options?: {
+    recursive?: boolean;
+    includeHidden?: boolean;
+    maxDepth?: number;
+    maxEntries?: number;
+    sortBy?: 'name' | 'size' | 'modified' | 'type';
+    includeSymlinkTargets?: boolean;
+}): Promise<ListDirectoryResult>;
+//# sourceMappingURL=list-directory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/list-directory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AA0R/B,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC5B,GACL,OAAO,CAAC,mBAAmB,CAAC,CA4C9B"}

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

@@ -0,0 +1,189 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { DEFAULT_MAX_DEPTH, DIR_TRAVERSAL_CONCURRENCY, PARALLEL_CONCURRENCY, } from '../constants.js';
+import { isHidden, processInParallel, runWorkQueue } from '../fs-helpers.js';
+import { validateExistingPath } from '../path-validation.js';
+import { sortByField } from './sorting.js';
+function initListState() {
+    return {
+        entries: [],
+        totalFiles: 0,
+        totalDirectories: 0,
+        maxDepthReached: 0,
+        truncated: false,
+        skippedInaccessible: 0,
+        symlinksNotFollowed: 0,
+    };
+}
+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 stats.isSymbolicLink() ? 'symlink' : 'other';
+}
+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,
+    };
+}
+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,
+            basePath,
+        });
+    }
+    catch {
+        return buildFallbackEntry(item, fullPath, relativePath);
+    }
+}
+function createStopChecker(maxEntries, state) {
+    return () => {
+        if (maxEntries !== undefined && state.entries.length >= maxEntries) {
+            state.truncated = true;
+            return true;
+        }
+        return false;
+    };
+}
+async function readVisibleItems(currentPath, includeHidden) {
+    try {
+        const items = await fs.readdir(currentPath, { withFileTypes: true });
+        return includeHidden ? items : items.filter((item) => !isHidden(item.name));
+    }
+    catch {
+        return null;
+    }
+}
+function applyDirectoryItemResult(result, state, enqueue) {
+    const { entry, enqueueDir, skippedInaccessible, symlinkNotFollowed } = result;
+    state.entries.push(entry);
+    if (entry.type === 'directory')
+        state.totalDirectories++;
+    if (entry.type === 'file')
+        state.totalFiles++;
+    if (enqueueDir)
+        enqueue(enqueueDir);
+    if (skippedInaccessible)
+        state.skippedInaccessible++;
+    if (symlinkNotFollowed)
+        state.symlinksNotFollowed++;
+}
+function processResults(results, state, enqueue, shouldStop) {
+    for (const result of results) {
+        if (shouldStop())
+            break;
+        applyDirectoryItemResult(result, state, enqueue);
+    }
+}
+async function handleDirectory(params, enqueue, config, state, shouldStop) {
+    if (params.depth > config.maxDepth)
+        return;
+    if (shouldStop())
+        return;
+    state.maxDepthReached = Math.max(state.maxDepthReached, params.depth);
+    const items = await readVisibleItems(params.currentPath, config.includeHidden);
+    if (!items) {
+        state.skippedInaccessible++;
+        return;
+    }
+    const { results, errors } = await processInParallel(items, async (item) => buildDirectoryItemResult(item, params.currentPath, config.basePath, {
+        includeSymlinkTargets: config.includeSymlinkTargets,
+        recursive: config.recursive,
+        depth: params.depth,
+        maxDepth: config.maxDepth,
+    }), PARALLEL_CONCURRENCY);
+    state.skippedInaccessible += errors.length;
+    processResults(results, state, enqueue, shouldStop);
+}
+export async function listDirectory(dirPath, options = {}) {
+    const { recursive = false, includeHidden = false, maxDepth = DEFAULT_MAX_DEPTH, maxEntries, sortBy = 'name', includeSymlinkTargets = false, } = options;
+    const basePath = await validateExistingPath(dirPath);
+    const state = initListState();
+    const shouldStop = createStopChecker(maxEntries, state);
+    const config = {
+        basePath,
+        recursive,
+        includeHidden,
+        maxDepth,
+        maxEntries,
+        includeSymlinkTargets,
+    };
+    await runWorkQueue([{ currentPath: basePath, depth: 0 }], async (params, enqueue) => handleDirectory(params, enqueue, config, state, shouldStop), DIR_TRAVERSAL_CONCURRENCY);
+    sortByField(state.entries, sortBy);
+    return {
+        path: basePath,
+        entries: state.entries,
+        summary: {
+            totalEntries: state.entries.length,
+            totalFiles: state.totalFiles,
+            totalDirectories: state.totalDirectories,
+            maxDepthReached: state.maxDepthReached,
+            truncated: state.truncated,
+            skippedInaccessible: state.skippedInaccessible,
+            symlinksNotFollowed: state.symlinksNotFollowed,
+        },
+    };
+}
+//# sourceMappingURL=list-directory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory.js","sourceRoot":"","sources":["../../../src/lib/file-operations/list-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAOlC,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAqB3C,SAAS,aAAa;IACpB,OAAO;QACL,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,CAAC;QACb,gBAAgB,EAAE,CAAC;QACnB,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,KAAK;QAChB,mBAAmB,EAAE,CAAC;QACtB,mBAAmB,EAAE,CAAC;KACvB,CAAC;AACJ,CAAC;AASD,SAAS,cAAc,CACrB,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,IAA4B;IAE5B,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,QAAQ;QACd,YAAY;QACZ,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,KAAY;IAClD,IAAI,IAAI,CAAC,WAAW,EAAE;QAAE,OAAO,WAAW,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,qBAA8B;IAE9B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,aAAiC,CAAC;IAEtC,IAAI,qBAAqB,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAmB;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,QAAQ;QACd,YAAY;QACZ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,aAAa;KACd,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,QAAgB,EAChB,KAAa,EACb,QAAgB,EAChB,SAAkB;IAElB,IAAI,CAAC,SAAS,IAAI,KAAK,GAAG,CAAC,GAAG,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEzD,OAAO;QACL,WAAW,EAAE,MAAM,oBAAoB,CAAC,QAAQ,CAAC;QACjD,KAAK,EAAE,KAAK,GAAG,CAAC;KACjB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,IAAY,EACZ,QAAgB,EAChB,YAAoB,EACpB,OAMC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAmB;QAC5B,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC;QACrD,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC9C,QAAQ,EAAE,KAAK,CAAC,KAAK;KACtB,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,eAAe,CACtC,QAAQ,EACR,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,SAAS,CAClB,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAY,EACZ,QAAgB,EAChB,YAAoB;IAEpB,MAAM,IAAI,GAA2B,IAAI,CAAC,WAAW,EAAE;QACrD,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE;YACb,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,OAAO,CAAC;IAEd,OAAO;QACL,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC;QACzD,mBAAmB,EAAE,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,IAAY,EACZ,WAAmB,EACnB,QAAgB,EAChB,OAKC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC;IAEpE,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1B,OAAO,MAAM,kBAAkB,CAC7B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,OAAO,CAAC,qBAAqB,CAC9B,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE;YAC5D,GAAG,OAAO;YACV,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,UAA8B,EAC9B,KAAyB;IAEzB,OAAO,GAAY,EAAE;QACnB,IAAI,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YACnE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,WAAmB,EACnB,aAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAC/B,MAA2B,EAC3B,KAAyB,EACzB,OAAgE;IAEhE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC;IAE9E,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACzD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,KAAK,CAAC,UAAU,EAAE,CAAC;IAC9C,IAAI,UAAU;QAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,mBAAmB;QAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC;IACrD,IAAI,kBAAkB;QAAE,KAAK,CAAC,mBAAmB,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CACrB,OAA8B,EAC9B,KAAyB,EACzB,OAAgE,EAChE,UAAyB;IAEzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,UAAU,EAAE;YAAE,MAAM;QACxB,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAA8C,EAC9C,OAAgE,EAChE,MAA2B,EAC3B,KAAyB,EACzB,UAAyB;IAEzB,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ;QAAE,OAAO;IAC3C,IAAI,UAAU,EAAE;QAAE,OAAO;IAEzB,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAEtE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAClC,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,aAAa,CACrB,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CACjD,KAAK,EACL,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE;QAClE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,EACJ,oBAAoB,CACrB,CAAC;IAEF,KAAK,CAAC,mBAAmB,IAAI,MAAM,CAAC,MAAM,CAAC;IAC3C,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,UAOI,EAAE;IAEN,MAAM,EACJ,SAAS,GAAG,KAAK,EACjB,aAAa,GAAG,KAAK,EACrB,QAAQ,GAAG,iBAAiB,EAC5B,UAAU,EACV,MAAM,GAAG,MAAM,EACf,qBAAqB,GAAG,KAAK,GAC9B,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAwB;QAClC,QAAQ;QACR,SAAS;QACT,aAAa;QACb,QAAQ;QACR,UAAU;QACV,qBAAqB;KACtB,CAAC;IAEF,MAAM,YAAY,CAChB,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CACxB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,EAC7D,yBAAyB,CAC1B,CAAC;IAEF,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEnC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE;YACP,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;YAC9C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;SAC/C;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/file-operations/pattern-complexity.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Estimates the complexity/performance impact of a glob pattern
+ * Helps users understand which patterns might be slow
+ */
+export interface PatternComplexityAnalysis {
+    complexity: 'fast' | 'moderate' | 'slow';
+    score: number;
+    factors: string[];
+    recommendations: string[];
+}
+export declare function analyzePatternComplexity(pattern: string): PatternComplexityAnalysis;
+/**
+ * Provides user-friendly complexity warning
+ */
+export declare function getComplexityWarning(analysis: PatternComplexityAnalysis): string | null;
+//# sourceMappingURL=pattern-complexity.d.ts.map

package/dist/lib/file-operations/pattern-complexity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-complexity.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/pattern-complexity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAWD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,GACd,yBAAyB,CAwE3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,yBAAyB,GAClC,MAAM,GAAG,IAAI,CAQf"}

package/dist/lib/file-operations/pattern-complexity.js

@@ -0,0 +1,86 @@
+/**
+ * Estimates the complexity/performance impact of a glob pattern
+ * Helps users understand which patterns might be slow
+ */
+const COMPLEXITY_WEIGHTS = {
+    leadingGlobstar: 15, // **/ at start
+    extglob: 20, // +(pattern), !(pattern), etc.
+    largeBraceExpansion: 25, // {a,b,c,...}
+    nestedQuantifiers: 30, // Complex regex
+    multiplePatternsInBrace: 10, // {a,b} = 10 points per item
+    leadingRecursion: 20, // Starting with **/
+};
+export function analyzePatternComplexity(pattern) {
+    let score = 0;
+    const factors = [];
+    const recommendations = [];
+    // Check for leading globstar
+    if (pattern.startsWith('**/')) {
+        score += COMPLEXITY_WEIGHTS.leadingGlobstar;
+        factors.push('Pattern starts with **/');
+        recommendations.push('Consider using a base directory if available (e.g., src/**/*.ts instead of **/src/**/*.ts)');
+    }
+    // Check for extglob patterns: +(), !(), ?(), *()
+    const extglobMatches = pattern.match(/[+!?*]\(\S+\)/g) ?? [];
+    if (extglobMatches.length > 0) {
+        score += extglobMatches.length * COMPLEXITY_WEIGHTS.extglob;
+        factors.push(`Extglob patterns: ${extglobMatches.join(', ')}`);
+        recommendations.push('Extglobs are slower. Use simpler patterns if possible (e.g., *.{js,ts} instead of +(js|ts))');
+    }
+    // Check for large brace expansions
+    const braceMatches = pattern.match(/\{[^}]*\}/g) ?? [];
+    for (const brace of braceMatches) {
+        const items = brace.slice(1, -1).split(',');
+        if (items.length > 20) {
+            score += COMPLEXITY_WEIGHTS.largeBraceExpansion;
+            factors.push(`Large brace expansion: ${items.length} items in {${items.slice(0, 3).join(',')}...}`);
+            recommendations.push('Use character classes or split into multiple simpler patterns');
+        }
+        else if (items.length > 5) {
+            score += items.length * COMPLEXITY_WEIGHTS.multiplePatternsInBrace;
+        }
+    }
+    // Check for nested quantifiers (regex complexity)
+    if (/([+*?}])\s*\)\s*([+*?{])/.test(pattern)) {
+        score += COMPLEXITY_WEIGHTS.nestedQuantifiers;
+        factors.push('Nested quantifiers detected');
+        recommendations.push('Simplify nested patterns to reduce regex complexity');
+    }
+    // Check for multiple ** segments
+    const globstarCount = (pattern.match(/\*\*/g) ?? []).length;
+    if (globstarCount > 2) {
+        score += 15;
+        factors.push(`Multiple globstars: ${globstarCount}`);
+        recommendations.push('Limit use of ** to narrow down search space');
+    }
+    // Determine complexity level
+    let complexity;
+    if (score < 20) {
+        complexity = 'fast';
+    }
+    else if (score < 50) {
+        complexity = 'moderate';
+    }
+    else {
+        complexity = 'slow';
+    }
+    return {
+        complexity,
+        score: Math.min(score, 100),
+        factors,
+        recommendations,
+    };
+}
+/**
+ * Provides user-friendly complexity warning
+ */
+export function getComplexityWarning(analysis) {
+    if (analysis.complexity === 'slow') {
+        return `⚠️ Pattern complexity is HIGH (score: ${analysis.score}/100). This search may take longer than expected. ${analysis.recommendations[0] ?? ''}`;
+    }
+    if (analysis.complexity === 'moderate' && analysis.score > 40) {
+        return `ℹ️ Pattern complexity is MODERATE (score: ${analysis.score}/100). Consider optimizing: ${analysis.recommendations[0] ?? ''}`;
+    }
+    return null;
+}
+//# sourceMappingURL=pattern-complexity.js.map

package/dist/lib/file-operations/pattern-complexity.js.map

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

package/dist/lib/file-operations/pattern-validator.d.ts

@@ -0,0 +1,15 @@
+export interface PatternValidationResult {
+    isValid: boolean;
+    error?: string;
+    suggestion?: string;
+}
+/**
+ * Validates glob patterns for safety and common mistakes
+ * Prevents backslashes, absolute paths, and overly complex patterns
+ */
+export declare function validateGlobPattern(pattern: string): PatternValidationResult;
+/**
+ * Throws McpError if pattern is invalid
+ */
+export declare function validateGlobPatternOrThrow(pattern: string, basePath: string): void;
+//# sourceMappingURL=pattern-validator.d.ts.map

package/dist/lib/file-operations/pattern-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-validator.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/pattern-validator.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAsD5E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,IAAI,CAaN"}