@j0hanz/fs-context-mcp 2.0.0

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

@@ -0,0 +1,80 @@
+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 openDirectory(currentPath, onInaccessible) {
+    try {
+        return await fs.opendir(currentPath);
+    }
+    catch {
+        onInaccessible();
+        return null;
+    }
+}
+function buildIterationEntry(currentPath, basePath, item) {
+    const fullPath = path.join(currentPath, item.name);
+    const relativePath = path.relative(basePath, fullPath);
+    return {
+        item,
+        name: item.name,
+        fullPath,
+        relativePath,
+    };
+}
+function shouldSkipEntry(entry, options) {
+    if (!options.includeHidden && isHidden(entry.name))
+        return true;
+    if (options.shouldExclude(entry.name, entry.relativePath))
+        return true;
+    return false;
+}
+async function iterateDirectoryEntries(dir, currentPath, basePath, options, handler) {
+    const shouldStop = options.shouldStop ?? (() => false);
+    for await (const item of dir) {
+        if (shouldStop())
+            break;
+        const entry = buildIterationEntry(currentPath, basePath, item);
+        if (shouldSkipEntry(entry, options))
+            continue;
+        await handler(entry);
+    }
+}
+export async function forEachDirectoryEntry(currentPath, basePath, options, handler) {
+    const dir = await openDirectory(currentPath, options.onInaccessible);
+    if (!dir)
+        return;
+    try {
+        await iterateDirectoryEntries(dir, currentPath, basePath, options, handler);
+    }
+    catch {
+        options.onInaccessible();
+    }
+    finally {
+        await dir.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=directory-helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory-helpers.js","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-helpers.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-builders.d.ts

@@ -0,0 +1,7 @@
+import type { DirectoryTreeResult, TreeEntry } from '../../config/types.js';
+import type { CollectedEntry, TreeState } from './directory-tree-helpers.js';
+export declare function buildChildrenByParent(directoriesFound: Set<string>, collectedEntries: CollectedEntry[]): Map<string, TreeEntry[]>;
+export declare function sortTreeChildren(childrenByParent: Map<string, TreeEntry[]>): void;
+export declare function buildTree(rootPath: string, childrenByParent: Map<string, TreeEntry[]>): TreeEntry;
+export declare function buildTreeSummary(state: TreeState): DirectoryTreeResult['summary'];
+//# sourceMappingURL=directory-tree-builders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory-tree-builders.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-tree-builders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7E,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC7B,gBAAgB,EAAE,cAAc,EAAE,GACjC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAgB1B;AAoBD,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,GACzC,IAAI,CASN;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,GACzC,SAAS,CAOX;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,GACf,mBAAmB,CAAC,SAAS,CAAC,CAShC"}

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

@@ -0,0 +1,58 @@
+import * as path from 'node:path';
+export function buildChildrenByParent(directoriesFound, collectedEntries) {
+    const childrenByParent = new Map();
+    for (const dirPath of directoriesFound) {
+        childrenByParent.set(dirPath, []);
+    }
+    for (const entry of collectedEntries) {
+        const treeEntry = buildTreeEntry(entry, childrenByParent);
+        const siblings = childrenByParent.get(entry.parentPath);
+        if (siblings) {
+            siblings.push(treeEntry);
+        }
+    }
+    return childrenByParent;
+}
+function buildTreeEntry(entry, childrenByParent) {
+    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) ?? [];
+    }
+    return treeEntry;
+}
+export 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);
+        });
+    }
+}
+export function buildTree(rootPath, childrenByParent) {
+    const rootName = path.basename(rootPath);
+    return {
+        name: rootName || rootPath,
+        type: 'directory',
+        children: childrenByParent.get(rootPath) ?? [],
+    };
+}
+export function buildTreeSummary(state) {
+    return {
+        totalFiles: state.totalFiles,
+        totalDirectories: state.totalDirectories,
+        maxDepthReached: state.maxDepthReached,
+        truncated: state.truncated,
+        skippedInaccessible: state.skippedInaccessible,
+        symlinksNotFollowed: state.symlinksNotFollowed,
+    };
+}
+//# sourceMappingURL=directory-tree-builders.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory-tree-builders.js","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-tree-builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,MAAM,UAAU,qBAAqB,CACnC,gBAA6B,EAC7B,gBAAkC;IAElC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;IAExD,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CACrB,KAAqB,EACrB,gBAA0C;IAE1C,MAAM,SAAS,GAAc;QAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACtD,SAAS,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,SAAS,CAAC,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,gBAA0C;IAE1C,KAAK,MAAM,QAAQ,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;gBACtB,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,gBAA0C;IAE1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,QAAQ,IAAI,QAAQ;QAC1B,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAgB;IAEhB,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;KAC/C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,33 @@
+export interface CollectedEntry {
+    parentPath: string;
+    name: string;
+    type: 'file' | 'directory';
+    size?: number;
+    depth: number;
+}
+export interface TreeState {
+    totalFiles: number;
+    totalDirectories: number;
+    maxDepthReached: number;
+    skippedInaccessible: number;
+    symlinksNotFollowed: number;
+    truncated: boolean;
+    collectedEntries: CollectedEntry[];
+    directoriesFound: Set<string>;
+}
+export declare function initTreeState(basePath: string): TreeState;
+export declare function handleTreeNode(params: {
+    currentPath: string;
+    depth: number;
+}, enqueue: (entry: {
+    currentPath: string;
+    depth: number;
+}) => void, state: TreeState, options: {
+    basePath: string;
+    maxDepth: number;
+    includeHidden: boolean;
+    includeSize: boolean;
+    maxFiles: number;
+    shouldExclude: (name: string, relativePath: string) => boolean;
+}): Promise<void>;
+//# sourceMappingURL=directory-tree-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory-tree-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/directory-tree-helpers.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAWzD;AA8JD,wBAAsB,cAAc,CAClC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9C,OAAO,EAAE,CAAC,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,EAChE,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAChE,GACA,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

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

@@ -0,0 +1,124 @@
+import * as fs from 'node:fs/promises';
+import { validateExistingPathDetailed } from '../path-validation.js';
+import { classifyAccessError, forEachDirectoryEntry, } from './directory-helpers.js';
+export 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 shouldStopAtMaxFiles(state, maxFiles) {
+    return hitMaxFiles(state, maxFiles);
+}
+async function resolveEntryPath(fullPath, item, state) {
+    if (item.isSymbolicLink()) {
+        state.symlinksNotFollowed++;
+        return null;
+    }
+    try {
+        const { resolvedPath, isSymlink } = await validateExistingPathDetailed(fullPath);
+        if (isSymlink) {
+            state.symlinksNotFollowed++;
+            return null;
+        }
+        return resolvedPath;
+    }
+    catch (error) {
+        if (classifyAccessError(error) === 'symlink') {
+            state.symlinksNotFollowed++;
+        }
+        else {
+            state.skippedInaccessible++;
+        }
+        return null;
+    }
+}
+async function getEntryStats(resolvedPath, state) {
+    try {
+        return await fs.stat(resolvedPath);
+    }
+    catch {
+        state.skippedInaccessible++;
+        return null;
+    }
+}
+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);
+    }
+}
+function handleStatsEntry(stats, params, name, resolvedPath, enqueue, state, options) {
+    if (stats.isFile()) {
+        addFileEntry(state, params, name, options.includeSize ? stats.size : undefined);
+        return;
+    }
+    if (stats.isDirectory()) {
+        addDirectoryEntry(state, params, name, resolvedPath, enqueue, options.maxDepth);
+    }
+}
+async function processTreeEntry(params, entry, enqueue, state, options) {
+    const resolvedPath = await resolveEntryPath(entry.fullPath, entry.item, state);
+    if (!resolvedPath)
+        return;
+    const stats = await getEntryStats(resolvedPath, state);
+    if (!stats)
+        return;
+    handleStatsEntry(stats, params, entry.name, resolvedPath, enqueue, state, options);
+}
+export async function handleTreeNode(params, enqueue, state, options) {
+    if (shouldStopAtMaxFiles(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: () => shouldStopAtMaxFiles(state, options.maxFiles),
+    }, async ({ item, name, fullPath }) => processTreeEntry(params, { item, name, fullPath }, enqueue, state, {
+        includeSize: options.includeSize,
+        maxDepth: options.maxDepth,
+    }));
+}
+//# sourceMappingURL=directory-tree-helpers.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { DirectoryTreeResult } from '../../config/types.js';
+export declare function getDirectoryTree(dirPath: string, options?: {
+    maxDepth?: number;
+    excludePatterns?: string[];
+    includeHidden?: boolean;
+    includeSize?: boolean;
+    maxFiles?: number;
+    signal?: AbortSignal;
+}): 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":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAiEjE,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;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACjB,GACL,OAAO,CAAC,mBAAmB,CAAC,CAyB9B"}

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

@@ -0,0 +1,60 @@
+import * as fs from 'node:fs/promises';
+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 { mergeDefined } from '../merge-defined.js';
+import { validateExistingPath } from '../path-validation.js';
+import { createExcludeMatcher } from './directory-helpers.js';
+import { buildChildrenByParent, buildTree, buildTreeSummary, sortTreeChildren, } from './directory-tree-builders.js';
+import { handleTreeNode, initTreeState, } from './directory-tree-helpers.js';
+async function resolveBaseDirectory(dirPath) {
+    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);
+    }
+    return basePath;
+}
+async function buildTreeState(basePath, options) {
+    const state = initTreeState(basePath);
+    await runWorkQueue([{ currentPath: basePath, depth: 0 }], async (params, enqueue) => handleTreeNode(params, enqueue, state, {
+        basePath,
+        maxDepth: options.maxDepth,
+        includeHidden: options.includeHidden,
+        includeSize: options.includeSize,
+        maxFiles: options.maxFiles,
+        shouldExclude: options.shouldExclude,
+    }), DIR_TRAVERSAL_CONCURRENCY, options.signal);
+    return state;
+}
+export async function getDirectoryTree(dirPath, options = {}) {
+    const normalized = normalizeTreeOptions(options);
+    const basePath = await resolveBaseDirectory(dirPath);
+    const shouldExclude = createExcludeMatcher(normalized.excludePatterns);
+    const state = await buildTreeState(basePath, {
+        maxDepth: normalized.maxDepth,
+        includeHidden: normalized.includeHidden,
+        includeSize: normalized.includeSize,
+        maxFiles: normalized.maxFiles,
+        shouldExclude,
+        signal: options.signal,
+    });
+    const childrenByParent = buildChildrenByParent(state.directoriesFound, state.collectedEntries);
+    sortTreeChildren(childrenByParent);
+    const tree = buildTree(basePath, childrenByParent);
+    return {
+        tree,
+        summary: buildTreeSummary(state),
+    };
+}
+function normalizeTreeOptions(options) {
+    const defaults = {
+        maxDepth: DEFAULT_TREE_DEPTH,
+        excludePatterns: [],
+        includeHidden: false,
+        includeSize: false,
+        maxFiles: DEFAULT_TREE_MAX_FILES,
+    };
+    return mergeDefined(defaults, options);
+}
+//# 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,6 @@
+import type { FileInfo } from '../../config/types.js';
+export declare function getFileInfo(filePath: string, options?: {
+    includeMimeType?: boolean;
+    signal?: AbortSignal;
+}): 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":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAqEtD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAChE,OAAO,CAAC,QAAQ,CAAC,CA0BnB"}