@j0hanz/fs-context-mcp 2.0.0

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

@@ -0,0 +1,80 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getMimeType } from '../constants.js';
+import { assertNotAborted, withAbort } from '../fs-helpers/abort.js';
+import { getFileType, isHidden } from '../fs-helpers/fs-utils.js';
+import { validateExistingPathDetailed } from '../path-validation/validate-existing.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}`;
+}
+function resolveMimeType(ext, includeMimeType) {
+    if (!includeMimeType)
+        return undefined;
+    if (!ext)
+        return undefined;
+    return getMimeType(ext);
+}
+async function resolveSymlinkTarget(pathToRead, isSymlink, signal) {
+    if (!isSymlink)
+        return undefined;
+    return getSymlinkTarget(pathToRead, signal);
+}
+function buildFileInfoResult(name, requestedPath, isSymlink, stats, mimeType, symlinkTarget) {
+    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,
+    };
+}
+export async function getFileInfo(filePath, options = {}) {
+    const { signal } = options;
+    assertNotAborted(signal);
+    const { requestedPath, resolvedPath, isSymlink } = await validateExistingPathDetailed(filePath, signal);
+    const name = path.basename(requestedPath);
+    const ext = path.extname(name).toLowerCase();
+    const includeMimeType = options.includeMimeType !== false;
+    const mimeType = resolveMimeType(ext, includeMimeType);
+    const symlinkTarget = await resolveSymlinkTarget(requestedPath, isSymlink, signal);
+    const stats = await withAbort(fs.stat(resolvedPath), signal);
+    return buildFileInfoResult(name, requestedPath, isSymlink, stats, mimeType, symlinkTarget);
+}
+async function getSymlinkTarget(pathToRead, signal) {
+    assertNotAborted(signal);
+    try {
+        return await withAbort(fs.readlink(pathToRead), signal);
+    }
+    catch (error) {
+        handleSymlinkError(error);
+        return undefined;
+    }
+}
+function handleSymlinkError(error) {
+    if (error instanceof Error && error.name === 'AbortError') {
+        throw error;
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,8 @@
+import type { GetMultipleFileInfoResult } from '../../config/types.js';
+interface GetMultipleFileInfoOptions {
+    includeMimeType?: boolean;
+    signal?: AbortSignal;
+}
+export declare function getMultipleFileInfo(paths: readonly string[], options?: GetMultipleFileInfoOptions): Promise<GetMultipleFileInfoResult>;
+export {};
+//# sourceMappingURL=get-multiple-file-info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-multiple-file-info.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/get-multiple-file-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,uBAAuB,CAAC;AAK/B,UAAU,0BAA0B;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAiGD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAYpC"}

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

@@ -0,0 +1,76 @@
+import { PARALLEL_CONCURRENCY } from '../constants.js';
+import { processInParallel } from '../fs-helpers/concurrency.js';
+import { getFileInfo } from './file-info.js';
+function buildEmptyResult() {
+    return {
+        results: [],
+        summary: { total: 0, succeeded: 0, failed: 0, totalSize: 0 },
+    };
+}
+function buildOutput(paths) {
+    return paths.map((filePath) => ({
+        path: filePath,
+    }));
+}
+async function processFileInfo(filePath, options) {
+    const info = await getFileInfo(filePath, {
+        includeMimeType: options.includeMimeType,
+        signal: options.signal,
+    });
+    return {
+        path: filePath,
+        info,
+    };
+}
+async function readFileInfoInParallel(paths, options) {
+    return await processInParallel(paths.map((filePath, index) => ({ filePath, index })), async ({ filePath, index }) => ({
+        index,
+        value: await processFileInfo(filePath, options),
+    }), PARALLEL_CONCURRENCY, options.signal);
+}
+function applyResults(output, results) {
+    for (const result of results) {
+        output[result.index] = result.value;
+    }
+}
+function applyErrors(output, errors, paths) {
+    for (const failure of errors) {
+        const filePath = paths[failure.index] ?? '(unknown)';
+        if (output[failure.index] !== undefined) {
+            output[failure.index] = { path: filePath, error: failure.error.message };
+        }
+    }
+}
+function calculateSummary(results) {
+    let succeeded = 0;
+    let failed = 0;
+    let totalSize = 0;
+    for (const result of results) {
+        if (result.info !== undefined) {
+            succeeded++;
+            totalSize += result.info.size;
+        }
+        else {
+            failed++;
+        }
+    }
+    return {
+        total: results.length,
+        succeeded,
+        failed,
+        totalSize,
+    };
+}
+export async function getMultipleFileInfo(paths, options = {}) {
+    if (paths.length === 0)
+        return buildEmptyResult();
+    const output = buildOutput(paths);
+    const { results, errors } = await readFileInfoInParallel(paths, options);
+    applyResults(output, results);
+    applyErrors(output, errors, paths);
+    return {
+        results: output,
+        summary: calculateSummary(output),
+    };
+}
+//# sourceMappingURL=get-multiple-file-info.js.map

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

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

package/dist/lib/file-operations/glob-engine.d.ts

@@ -0,0 +1,27 @@
+import type { Stats } from 'node:fs';
+interface DirentLike {
+    isDirectory(): boolean;
+    isFile(): boolean;
+    isSymbolicLink(): boolean;
+}
+export interface GlobEntry {
+    path: string;
+    dirent: DirentLike;
+    stats?: Stats;
+}
+export interface GlobEntriesOptions {
+    cwd: string;
+    pattern: string;
+    excludePatterns: readonly string[];
+    includeHidden: boolean;
+    baseNameMatch: boolean;
+    caseSensitiveMatch: boolean;
+    maxDepth?: number;
+    followSymbolicLinks: boolean;
+    onlyFiles: boolean;
+    stats: boolean;
+    suppressErrors?: boolean;
+}
+export declare function globEntries(options: GlobEntriesOptions): AsyncGenerator<GlobEntry>;
+export {};
+//# sourceMappingURL=glob-engine.d.ts.map

package/dist/lib/file-operations/glob-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-engine.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/glob-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAWrC,UAAU,UAAU;IAClB,WAAW,IAAI,OAAO,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;IAClB,cAAc,IAAI,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAkCD,wBAAuB,WAAW,CAChC,OAAO,EAAE,kBAAkB,GAC1B,cAAc,CAAC,SAAS,CAAC,CAmB3B"}

package/dist/lib/file-operations/glob-engine.js

@@ -0,0 +1,51 @@
+import fg from 'fast-glob';
+import { publishOpsTraceEnd, publishOpsTraceError, publishOpsTraceStart, shouldPublishOpsTrace, } from '../observability/diagnostics.js';
+async function* fastGlobEntries(options) {
+    const stream = fg.stream(options.pattern, {
+        cwd: options.cwd,
+        absolute: true,
+        dot: options.includeHidden,
+        ignore: [...options.excludePatterns],
+        followSymbolicLinks: options.followSymbolicLinks,
+        baseNameMatch: options.baseNameMatch,
+        caseSensitiveMatch: options.caseSensitiveMatch,
+        onlyFiles: options.onlyFiles,
+        stats: options.stats,
+        objectMode: true,
+        deep: options.maxDepth ?? Number.POSITIVE_INFINITY,
+        suppressErrors: options.suppressErrors,
+    });
+    for await (const entry of stream) {
+        if (typeof entry === 'string' || Buffer.isBuffer(entry))
+            continue;
+        yield {
+            path: entry.path,
+            dirent: entry.dirent,
+            stats: entry.stats,
+        };
+    }
+}
+export async function* globEntries(options) {
+    const engine = 'fast-glob';
+    const traceContext = shouldPublishOpsTrace()
+        ? {
+            op: 'globEntries',
+            engine,
+        }
+        : undefined;
+    if (traceContext)
+        publishOpsTraceStart(traceContext);
+    try {
+        yield* fastGlobEntries(options);
+    }
+    catch (error) {
+        if (traceContext)
+            publishOpsTraceError(traceContext, error);
+        throw error;
+    }
+    finally {
+        if (traceContext)
+            publishOpsTraceEnd(traceContext);
+    }
+}
+//# sourceMappingURL=glob-engine.js.map

package/dist/lib/file-operations/glob-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-engine.js","sourceRoot":"","sources":["../../../src/lib/file-operations/glob-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,WAAW,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AA8BzC,KAAK,SAAS,CAAC,CAAC,eAAe,CAC7B,OAA2B;IAE3B,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE;QACxC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,OAAO,CAAC,aAAa;QAC1B,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;QACpC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,iBAAiB;QAClD,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAEzB,EAAE,CAAC;QACF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAClE,MAAM;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAChC,OAA2B;IAE3B,MAAM,MAAM,GAAG,WAAW,CAAC;IAE3B,MAAM,YAAY,GAAG,qBAAqB,EAAE;QAC1C,CAAC,CAAC;YACE,EAAE,EAAE,aAAa;YACjB,MAAM;SACP;QACH,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,YAAY;QAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,YAAY;YAAE,oBAAoB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC5D,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,YAAY;YAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { Stats } from 'node:fs';
+import type { DirectoryEntry } from '../../config/types.js';
+export interface EntryTotals {
+    files: number;
+    directories: number;
+}
+export interface EntryCandidate {
+    path: string;
+    dirent: {
+        isDirectory(): boolean;
+        isSymbolicLink(): boolean;
+        isFile(): boolean;
+    };
+    stats?: Stats;
+}
+export interface SymlinkOptions {
+    includeSymlinkTargets: boolean;
+}
+export declare function appendEntry(basePath: string, entry: EntryCandidate, options: SymlinkOptions, needsStats: boolean, totals: EntryTotals, entries: DirectoryEntry[]): Promise<void>;
+//# sourceMappingURL=list-directory-entry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory-entry.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/list-directory-entry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,WAAW,IAAI,OAAO,CAAC;QACvB,cAAc,IAAI,OAAO,CAAC;QAC1B,MAAM,IAAI,OAAO,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAiDD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAWf"}

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

@@ -0,0 +1,44 @@
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+function resolveEntryType(dirent) {
+    if (dirent.isDirectory())
+        return 'directory';
+    if (dirent.isSymbolicLink())
+        return 'symlink';
+    if (dirent.isFile())
+        return 'file';
+    return 'other';
+}
+function resolveRelativePath(basePath, entryPath) {
+    return path.relative(basePath, entryPath) || path.basename(entryPath);
+}
+async function resolveSymlinkTarget(entryType, includeSymlinkTargets, entryPath) {
+    if (entryType !== 'symlink' || !includeSymlinkTargets) {
+        return undefined;
+    }
+    return await fsp.readlink(entryPath).catch(() => undefined);
+}
+function updateTotals(type, totals) {
+    if (type === 'file')
+        totals.files += 1;
+    if (type === 'directory')
+        totals.directories += 1;
+}
+function buildDirectoryEntry(basePath, entry, entryType, needsStats, symlinkTarget) {
+    return {
+        name: path.basename(entry.path),
+        path: entry.path,
+        relativePath: resolveRelativePath(basePath, entry.path),
+        type: entryType,
+        size: needsStats && entry.stats?.isFile() ? entry.stats.size : undefined,
+        modified: needsStats ? entry.stats?.mtime : undefined,
+        symlinkTarget,
+    };
+}
+export async function appendEntry(basePath, entry, options, needsStats, totals, entries) {
+    const entryType = resolveEntryType(entry.dirent);
+    const symlinkTarget = await resolveSymlinkTarget(entryType, options.includeSymlinkTargets, entry.path);
+    updateTotals(entryType, totals);
+    entries.push(buildDirectoryEntry(basePath, entry, entryType, needsStats, symlinkTarget));
+}
+//# sourceMappingURL=list-directory-entry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory-entry.js","sourceRoot":"","sources":["../../../src/lib/file-operations/list-directory-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAwBlC,SAAS,gBAAgB,CACvB,MAAgC;IAEhC,IAAI,MAAM,CAAC,WAAW,EAAE;QAAE,OAAO,WAAW,CAAC;IAC7C,IAAI,MAAM,CAAC,cAAc,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,MAAM,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB,EAAE,SAAiB;IAC9D,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACxE,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,SAAiC,EACjC,qBAA8B,EAC9B,SAAiB;IAEjB,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,IAA4B,EAAE,MAAmB;IACrE,IAAI,IAAI,KAAK,MAAM;QAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,WAAW;QAAE,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,KAAsC,EACtC,SAAiC,EACjC,UAAmB,EACnB,aAAiC;IAEjC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC;QACvD,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACxE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS;QACrD,aAAa;KACd,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,KAAqB,EACrB,OAAuB,EACvB,UAAmB,EACnB,MAAmB,EACnB,OAAyB;IAEzB,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAC9C,SAAS,EACT,OAAO,CAAC,qBAAqB,EAC7B,KAAK,CAAC,IAAI,CACX,CAAC;IACF,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CACV,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,CAAC,CAC3E,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { DirectoryEntry, ListDirectoryResult } from '../../config/types.js';
+export interface ListDirectoryOptions {
+    includeHidden?: boolean;
+    excludePatterns?: readonly string[];
+    maxDepth?: number;
+    maxEntries?: number;
+    sortBy?: 'name' | 'size' | 'modified' | 'type';
+    includeSymlinkTargets?: boolean;
+    pattern?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export type NormalizedOptions = Required<Omit<ListDirectoryOptions, 'signal' | 'pattern'>> & {
+    pattern?: string;
+};
+export declare function normalizeOptions(options: ListDirectoryOptions): NormalizedOptions;
+export declare function executeListDirectory(basePath: string, normalized: NormalizedOptions, signal: AbortSignal): Promise<{
+    entries: DirectoryEntry[];
+    summary: ListDirectoryResult['summary'];
+}>;
+//# sourceMappingURL=list-directory-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/list-directory-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAa/B,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,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;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CACtC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAC,CACjD,GAAG;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAOF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,GAC5B,iBAAiB,CAWnB;AAsHD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IACT,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;CACzC,CAAC,CAiBD"}

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

@@ -0,0 +1,103 @@
+import { DEFAULT_LIST_MAX_ENTRIES, DEFAULT_MAX_DEPTH, DEFAULT_SEARCH_TIMEOUT_MS, } from '../constants.js';
+import { globEntries } from './glob-engine.js';
+import { appendEntry, } from './list-directory-entry.js';
+function normalizePattern(pattern) {
+    if (!pattern || pattern.length === 0)
+        return undefined;
+    return pattern;
+}
+export function normalizeOptions(options) {
+    return {
+        includeHidden: options.includeHidden ?? false,
+        excludePatterns: options.excludePatterns ?? [],
+        maxDepth: options.maxDepth ?? DEFAULT_MAX_DEPTH,
+        maxEntries: options.maxEntries ?? DEFAULT_LIST_MAX_ENTRIES,
+        sortBy: options.sortBy ?? 'name',
+        includeSymlinkTargets: options.includeSymlinkTargets ?? false,
+        pattern: normalizePattern(options.pattern),
+        timeoutMs: options.timeoutMs ?? DEFAULT_SEARCH_TIMEOUT_MS,
+    };
+}
+function sortEntries(entries, sortBy) {
+    const compare = {
+        name: (a, b) => a.name.localeCompare(b.name),
+        type: (a, b) => a.type.localeCompare(b.type),
+        size: (a, b) => (a.size ?? 0) - (b.size ?? 0),
+        modified: (a, b) => (a.modified?.getTime() ?? 0) - (b.modified?.getTime() ?? 0),
+    }[sortBy];
+    entries.sort(compare);
+}
+function needsStatsForSort(sortBy) {
+    return sortBy === 'size' || sortBy === 'modified';
+}
+function resolveMaxDepth(normalized) {
+    if (!normalized.pattern) {
+        return 1; // Always shallow listing unless a pattern is provided
+    }
+    return normalized.maxDepth;
+}
+function shouldStopScan(signal, entryCount, maxEntries) {
+    if (signal.aborted) {
+        return { stop: true, reason: 'aborted' };
+    }
+    if (entryCount >= maxEntries) {
+        return { stop: true, reason: 'maxEntries' };
+    }
+    return { stop: false };
+}
+function createEntryStream(basePath, normalized, maxDepth, needsStats) {
+    return globEntries({
+        cwd: basePath,
+        pattern: normalized.pattern ?? '*',
+        excludePatterns: normalized.excludePatterns,
+        includeHidden: normalized.includeHidden,
+        baseNameMatch: false,
+        caseSensitiveMatch: true,
+        maxDepth,
+        followSymbolicLinks: false,
+        onlyFiles: false,
+        stats: needsStats,
+    });
+}
+function buildSummary(entries, totals, maxDepth, truncated, stoppedReason) {
+    return {
+        totalEntries: entries.length,
+        entriesScanned: entries.length,
+        entriesVisible: entries.length,
+        totalFiles: totals.files,
+        totalDirectories: totals.directories,
+        maxDepthReached: maxDepth,
+        truncated,
+        stoppedReason,
+        skippedInaccessible: 0,
+        symlinksNotFollowed: 0,
+    };
+}
+async function collectEntries(basePath, normalized, signal, needsStats, maxDepth) {
+    const entries = [];
+    const totals = { files: 0, directories: 0 };
+    let truncated = false;
+    let stoppedReason;
+    const stream = createEntryStream(basePath, normalized, maxDepth, needsStats);
+    for await (const entry of stream) {
+        const stop = shouldStopScan(signal, entries.length, normalized.maxEntries);
+        if (stop.stop) {
+            truncated = true;
+            stoppedReason = stop.reason;
+            break;
+        }
+        await appendEntry(basePath, entry, normalized, needsStats, totals, entries);
+    }
+    return { entries, totals, truncated, stoppedReason };
+}
+export async function executeListDirectory(basePath, normalized, signal) {
+    const needsStats = needsStatsForSort(normalized.sortBy);
+    const maxDepth = resolveMaxDepth(normalized);
+    const { entries, totals, truncated, stoppedReason } = await collectEntries(basePath, normalized, signal, needsStats, maxDepth);
+    sortEntries(entries, normalized.sortBy);
+    return {
+        entries,
+        summary: buildSummary(entries, totals, maxDepth, truncated, stoppedReason),
+    };
+}
+//# sourceMappingURL=list-directory-helpers.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { Dirent } from 'node:fs';
+import type { Minimatch } from 'minimatch';
+export declare function buildExcludeMatchers(excludePatterns: string[]): Minimatch[];
+export declare function buildPatternMatcher(pattern: string | undefined): Minimatch | undefined;
+export declare function streamVisibleItems(currentPath: string, basePath: string, includeHidden: boolean, excludeMatchers: Minimatch[], onInaccessible: () => void, onScanned: () => void, onVisible: () => void, signal?: AbortSignal): AsyncIterable<Dirent>;
+//# sourceMappingURL=list-directory-matching.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-directory-matching.d.ts","sourceRoot":"","sources":["../../../src/lib/file-operations/list-directory-matching.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AA+B3C,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAK3E;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,SAAS,GAAG,SAAS,CAGvB;AAgCD,wBAAuB,kBAAkB,CACvC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,OAAO,EACtB,eAAe,EAAE,SAAS,EAAE,EAC5B,cAAc,EAAE,MAAM,IAAI,EAC1B,SAAS,EAAE,MAAM,IAAI,EACrB,SAAS,EAAE,MAAM,IAAI,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,MAAM,CAAC,CAkBvB"}

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

@@ -0,0 +1,94 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { minimatch } from 'minimatch';
+import { isHidden } from '../fs-helpers.js';
+import { withAbort } from '../fs-helpers/abort.js';
+const EXCLUDE_MATCH_OPTIONS = {
+    dot: true,
+    nocase: process.platform === 'win32',
+    windowsPathsNoEscape: true,
+};
+const PATTERN_MATCH_OPTIONS = {
+    dot: true,
+};
+async function openDirectory(currentPath, onInaccessible, signal) {
+    try {
+        return await withAbort(fs.opendir(currentPath), signal);
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw error;
+        }
+        onInaccessible();
+        return null;
+    }
+}
+export function buildExcludeMatchers(excludePatterns) {
+    if (excludePatterns.length === 0)
+        return [];
+    return excludePatterns.map((pattern) => new minimatch.Minimatch(pattern, EXCLUDE_MATCH_OPTIONS));
+}
+export function buildPatternMatcher(pattern) {
+    if (!pattern)
+        return undefined;
+    return new minimatch.Minimatch(pattern, PATTERN_MATCH_OPTIONS);
+}
+function shouldExcludeEntry(item, currentPath, basePath, excludeMatchers) {
+    if (excludeMatchers.length === 0)
+        return false;
+    const relativePath = path.relative(basePath, path.join(currentPath, item.name)) || item.name;
+    const normalizedRelative = relativePath.replace(/\\/g, '/');
+    return excludeMatchers.some((matcher) => matcher.match(item.name) || matcher.match(normalizedRelative));
+}
+function shouldIncludeEntry(item, currentPath, basePath, options) {
+    if (!options.includeHidden && isHidden(item.name))
+        return false;
+    if (shouldExcludeEntry(item, currentPath, basePath, options.excludeMatchers)) {
+        return false;
+    }
+    return true;
+}
+export async function* streamVisibleItems(currentPath, basePath, includeHidden, excludeMatchers, onInaccessible, onScanned, onVisible, signal) {
+    if (signal?.aborted)
+        return;
+    const dir = await openDirectory(currentPath, onInaccessible, signal);
+    if (!dir)
+        return;
+    try {
+        yield* iterateVisibleItems(dir, currentPath, basePath, {
+            includeHidden,
+            excludeMatchers,
+            onScanned,
+            onVisible,
+            signal,
+        });
+    }
+    catch {
+        onInaccessible();
+    }
+    finally {
+        await dir.close().catch(() => { });
+    }
+}
+async function* iterateVisibleItems(dir, currentPath, basePath, options) {
+    for await (const item of dir) {
+        if (options.signal?.aborted)
+            break;
+        if (!handleStreamItem(item, currentPath, basePath, options)) {
+            continue;
+        }
+        yield item;
+    }
+}
+function handleStreamItem(item, currentPath, basePath, options) {
+    options.onScanned();
+    if (!shouldIncludeEntry(item, currentPath, basePath, {
+        includeHidden: options.includeHidden,
+        excludeMatchers: options.excludeMatchers,
+    })) {
+        return false;
+    }
+    options.onVisible();
+    return true;
+}
+//# sourceMappingURL=list-directory-matching.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ListDirectoryResult } from '../../config/types.js';
+import { type ListDirectoryOptions } from './list-directory-helpers.js';
+export declare function listDirectory(dirPath: string, options?: ListDirectoryOptions): 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":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,6BAA6B,CAAC;AAErC,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAkB9B"}

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

@@ -0,0 +1,16 @@
+import { createTimedAbortSignal } from '../fs-helpers/abort.js';
+import { validateExistingDirectory } from '../path-validation/validate-existing.js';
+import { executeListDirectory, normalizeOptions, } from './list-directory-helpers.js';
+export async function listDirectory(dirPath, options = {}) {
+    const normalized = normalizeOptions(options);
+    const { signal, cleanup } = createTimedAbortSignal(options.signal, normalized.timeoutMs);
+    const basePath = await validateExistingDirectory(dirPath, signal);
+    try {
+        const { entries, summary } = await executeListDirectory(basePath, normalized, signal);
+        return { path: basePath, entries, summary };
+    }
+    finally {
+        cleanup();
+    }
+}
+//# 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":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EACL,oBAAoB,EAEpB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,UAAgC,EAAE;IAElC,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAChD,OAAO,CAAC,MAAM,EACd,UAAU,CAAC,SAAS,CACrB,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,oBAAoB,CACrD,QAAQ,EACR,UAAU,EACV,MAAM,CACP,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}