@j0hanz/filesystem-mcp 1.8.0 → 1.9.0

package/dist/tools/delete-file.js

@@ -2,7 +2,7 @@ import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { ErrorCode, isNodeError, McpError } from '../lib/errors.js';
 import { withAbort } from '../lib/fs-helpers.js';
-import { isAllowedDirectoryRoot, validatePathForWrite, } from '../lib/path-validation.js';
+import { isAllowedDirectoryRoot, validatePathForWrite } from '../lib/paths.js';
 import { DeleteFileInputSchema, DeleteFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
@@ -14,8 +14,8 @@ export const DELETE_FILE_TOOL = {
     outputSchema: DeleteFileOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
     gotchas: [
-        'Deletion is permanent — there is no undo or recycle bin.',
-        'Non-empty directory delete requires `recursive=true`; else returns actionable input error.',
+        'No undo — deletion is permanent.',
+        'Non-empty directories require `recursive=true`.',
     ],
 };
 async function handleDeleteFile(args, signal) {

package/dist/tools/diff-files.js

@@ -4,7 +4,7 @@ import { createTwoFilesPatch } from 'diff';
 import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
 import { ErrorCode, McpError } from '../lib/errors.js';
 import { withAbort } from '../lib/fs-helpers.js';
-import { validateExistingPath } from '../lib/path-validation.js';
+import { validateExistingPath } from '../lib/paths.js';
 import { DiffFilesInputSchema, DiffFilesOutputSchema } from '../schemas.js';
 import { buildResourceLink, buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, maybeExternalizeTextContent, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
@@ -13,7 +13,7 @@ export const DIFF_FILES_TOOL = {
     title: 'Diff Files',
     description: 'Generate a unified diff between two files. ' +
         'Output feeds directly into `apply_patch`. ' +
-        'Check `isIdentical` in the response — if true, the files are already in sync and no patch is needed.',
+        '`isIdentical=true` means files match \u2014 no patch needed.',
     inputSchema: DiffFilesInputSchema,
     outputSchema: DiffFilesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/edit-file.js

@@ -1,28 +1,24 @@
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import RE2 from 're2';
-import { ErrorCode } from '../lib/errors.js';
-import { atomicWriteFile } from '../lib/fs-helpers.js';
-import { validateExistingPath } from '../lib/path-validation.js';
+import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
+import { ErrorCode, McpError } from '../lib/errors.js';
+import { atomicWriteFile, withAbort } from '../lib/fs-helpers.js';
+import { assertAllowedFileAccess, validateExistingPath } from '../lib/paths.js';
 import { EditFileInputSchema, EditFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const EDIT_FILE_TOOL = {
     name: 'edit',
     title: 'Edit File',
-    description: 'Edit a file by replacing text. Sequentially applies a list of string replacements. ' +
-        'Replaces the first occurrence of each `oldText`. ' +
-        '`oldText` must match exactly — include 3–5 lines of surrounding context to uniquely target the location. ' +
-        'Use `dryRun: true` to validate edits before writing.',
+    description: 'Apply sequential literal string replacements to a file (first occurrence per edit). ' +
+        '`oldText` must match exactly \u2014 include 3\u20135 lines of context for unique targeting. ' +
+        'Use `dryRun:true` to preview.',
     inputSchema: EditFileInputSchema,
     outputSchema: EditFileOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
-    nuances: [
-        'Apply sequential literal replacements (first occurrence per edit).',
-    ],
-    gotchas: [
-        '`oldText` must match exactly; unmatched items are reported in `unmatchedEdits`.',
-    ],
+    nuances: ['Each edit applies to the output of the previous edit.'],
+    gotchas: ['Unmatched `oldText` entries listed in `unmatchedEdits`.'],
 };
 function escapeRegExp(string) {
     return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
@@ -88,6 +84,11 @@ function applyEdits(content, edits, ignoreWhitespace) {
 }
 export async function handleEditFile(args, signal) {
     const validPath = await validateExistingPath(args.path, signal);
+    assertAllowedFileAccess(args.path, validPath);
+    const stats = await withAbort(fs.stat(validPath), signal);
+    if (stats.size > MAX_TEXT_FILE_SIZE) {
+        throw new McpError(ErrorCode.E_TOO_LARGE, `File too large for edit: ${args.path} (${stats.size} bytes > ${MAX_TEXT_FILE_SIZE} bytes)`, args.path, { size: stats.size, maxFileSize: MAX_TEXT_FILE_SIZE });
+    }
     const content = await fs.readFile(validPath, { encoding: 'utf-8', signal });
     const { content: newContent, appliedEdits, unmatchedEdits, lineRange, } = applyEdits(content, args.edits, args.ignoreWhitespace);
     const structured = {

package/dist/tools/list-directory.js

@@ -1,19 +1,17 @@
 import * as path from 'node:path';
-import { formatOperationSummary, joinLines } from '../config.js';
 import { DEFAULT_EXCLUDE_PATTERNS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
-import { listDirectory } from '../lib/file-operations/list-directory.js';
+import { listDirectory } from '../lib/file-operations/metadata.js';
+import { formatOperationSummary, joinLines } from '../config.js';
 import { ListDirectoryInputSchema, ListDirectoryOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, decodeOffsetCursor, encodeOffsetCursor, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const LIST_DIRECTORY_TOOL = {
     name: 'ls',
     title: 'List Directory',
-    description: 'List the immediate contents of a directory (non-recursive). ' +
-        'Returns name, relative path, type (file/directory/symlink), size, and modified date. ' +
-        'Omit path to list the workspace root. ' +
-        'Use includeIgnored=true to include ignored directories like node_modules. ' +
-        'For recursive searches, use find instead.',
+    description: 'List immediate directory contents (non-recursive): name, path, type, size, modified date. ' +
+        'Omit path for workspace root. `includeIgnored=true` for node_modules etc. ' +
+        'For recursive search, use `find`.',
     inputSchema: ListDirectoryInputSchema,
     outputSchema: ListDirectoryOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/move-file.js

@@ -2,7 +2,7 @@ import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { ErrorCode, formatUnknownErrorMessage, isNodeError, McpError, } from '../lib/errors.js';
 import { withAbort } from '../lib/fs-helpers.js';
-import { validateExistingPath, validatePathForWrite, } from '../lib/path-validation.js';
+import { assertAllowedFileAccess, validateExistingPath, validatePathForWrite, } from '../lib/paths.js';
 import { MoveFileInputSchema, MoveFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
@@ -48,6 +48,7 @@ export async function handleMoveFile(args, signal) {
         let validSource;
         try {
             validSource = await validateExistingPath(src, signal);
+            assertAllowedFileAccess(src, validSource);
         }
         catch (error) {
             failed.push({

package/dist/tools/read-multiple.js

@@ -1,16 +1,15 @@
 import * as path from 'node:path';
 import { DEFAULT_READ_MANY_MAX_TOTAL_SIZE, DEFAULT_SEARCH_TIMEOUT_MS, } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
-import { readMultipleFiles } from '../lib/file-operations/read-multiple-files.js';
+import { readMultipleFiles } from '../lib/file-operations/metadata.js';
 import { ReadMultipleFilesInputSchema, ReadMultipleFilesOutputSchema, } from '../schemas.js';
 import { buildBatchCompletionSuffix, buildBatchPathContext, buildResourceLink, buildToolErrorResponse, buildToolResponse, createBatchProgressCallbacks, executeToolWithDiagnostics, maybeExternalizeTextContent, READ_ONLY_TOOL_ANNOTATIONS, resolveFinalProgressCurrent, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const READ_MULTIPLE_FILES_TOOL = {
     name: 'read_many',
     title: 'Read Multiple Files',
-    description: 'Read multiple text files in a single request. ' +
-        'Returns contents and metadata for each file. ' +
-        'For single file, use read for simpler output.',
+    description: 'Read multiple text files in one request with contents and metadata. ' +
+        'For a single file, use `read`.',
     inputSchema: ReadMultipleFilesInputSchema,
     outputSchema: ReadMultipleFilesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/read.js

@@ -8,9 +8,9 @@ import { registerToolTaskIfAvailable } from './task-support.js';
 export const READ_FILE_TOOL = {
     name: 'read',
     title: 'Read File',
-    description: 'Read the text contents of a file. ' +
-        'Use head parameter to preview the first N lines of large files. ' +
-        'For multiple files, use read_many for efficiency.',
+    description: 'Read text file contents. ' +
+        'Use `head` to preview first N lines of large files. ' +
+        'For multiple files, use `read_many`.',
     inputSchema: ReadFileInputSchema,
     outputSchema: ReadFileOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/replace-in-files.js

@@ -5,28 +5,26 @@ import RE2 from 're2';
 import safeRegex from 'safe-regex2';
 import { DEFAULT_EXCLUDE_PATTERNS, MAX_TEXT_FILE_SIZE, PARALLEL_CONCURRENCY, } from '../lib/constants.js';
 import { ErrorCode, formatUnknownErrorMessage, McpError, } from '../lib/errors.js';
-import { globEntries } from '../lib/file-operations/glob-engine.js';
+import { globEntries } from '../lib/file-operations/traversal.js';
 import { atomicWriteFile, withAbort } from '../lib/fs-helpers.js';
-import { validateExistingPath, validatePathForWrite, } from '../lib/path-validation.js';
-import { reportPeriodicProgress } from '../lib/progress-reporting.js';
+import { validateExistingPath, validatePathForWrite } from '../lib/paths.js';
+import { reportPeriodicProgress } from '../lib/utils.js';
 import { SearchAndReplaceInputSchema, SearchAndReplaceOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, createToolProgressSession, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, resolveFinalProgressCurrent, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const SEARCH_AND_REPLACE_TOOL = {
     name: 'search_and_replace',
     title: 'Search and Replace',
-    description: 'Search and replace text across multiple files matching a glob pattern. ' +
-        'Replaces ALL occurrences in each file (unlike `edit` which replaces only the first). ' +
-        'Use `filePattern` to scope which files are touched. ' +
-        'Always run with `dryRun: true` first to verify matches before writing. ' +
-        'Returns a unified diff of changes in `dryRun` mode. ' +
-        'Literal mode (default) matches exact text; `isRegex: true` enables RE2 regex with capture groups ($1, $2).',
+    description: 'Bulk search-and-replace across files matching a glob. ' +
+        'Replaces ALL occurrences per file (unlike `edit`: first only). ' +
+        'Always `dryRun:true` first \u2014 returns a unified diff. ' +
+        'Literal matching by default; `isRegex:true` enables RE2 with capture groups ($1, $2).',
     inputSchema: SearchAndReplaceInputSchema,
     outputSchema: SearchAndReplaceOutputSchema,
     annotations: DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS,
     taskSupport: 'optional',
     gotchas: [
-        'Literal mode is default; `isRegex=true` enables RE2 + capture replacements (`$1`, `$2`).',
+        'Replaces ALL occurrences — not just the first. Use `edit` for single replacements.',
     ],
     nuances: [
         'Changed-file sample and failure sample are capped/truncated in output.',

package/dist/tools/roots.js

@@ -1,19 +1,17 @@
-import { joinLines } from '../config.js';
 import { ErrorCode } from '../lib/errors.js';
-import { getAllowedDirectories } from '../lib/path-validation.js';
+import { getAllowedDirectories } from '../lib/paths.js';
+import { joinLines } from '../config.js';
 import { ListAllowedDirectoriesInputSchema, ListAllowedDirectoriesOutputSchema, } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const LIST_ALLOWED_DIRECTORIES_TOOL = {
     name: 'roots',
     title: 'Workspace Roots',
-    description: 'List the workspace roots this server can access. ' +
-        'Call this first to see available directories. ' +
-        'All other tools only work within these directories.',
+    description: 'List allowed workspace roots. Call first \u2014 all other tools are scoped to these directories.',
     inputSchema: ListAllowedDirectoriesInputSchema,
     outputSchema: ListAllowedDirectoriesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
-    nuances: ['Other tools are constrained to these roots.'],
+    nuances: ['Returns absolute paths of all allowed directories.'],
 };
 function buildTextRoots(dirs) {
     if (dirs.length === 0) {

package/dist/tools/search-content.js

@@ -1,9 +1,9 @@
 import * as path from 'node:path';
 import RE2 from 're2';
-import { formatOperationSummary, joinLines } from '../config.js';
 import { DEFAULT_EXCLUDE_PATTERNS } from '../lib/constants.js';
 import { ErrorCode, formatUnknownErrorMessage, McpError, } from '../lib/errors.js';
-import { searchContent } from '../lib/file-operations/search-content.js';
+import { searchContent } from '../lib/file-operations/search.js';
+import { formatOperationSummary, joinLines } from '../config.js';
 import { SearchContentInputSchema, SearchContentOutputSchema, } from '../schemas.js';
 import { buildResourceLink, buildToolErrorResponse, buildToolResponse, createToolProgressSession, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, resolveFinalProgressCurrent, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
@@ -11,20 +11,18 @@ const MAX_INLINE_MATCHES = parseInt(process.env['FS_CONTEXT_MAX_INLINE_MATCHES']
 export const SEARCH_CONTENT_TOOL = {
     name: 'grep',
     title: 'Search Content',
-    description: 'Search for text within file contents (grep-like). ' +
-        'Returns matching lines. ' +
-        'Path may be a directory or a single file. ' +
-        'Use `filePattern` to scope by file type (e.g. `**/*.ts`) and avoid noisy results. ' +
-        'Use includeHidden=true to include hidden files and directories.',
+    description: 'Search file contents for text (grep-like). Returns matching lines. ' +
+        'Scope with `filePattern` (e.g. `**/*.ts`) to reduce noise. ' +
+        '`includeHidden=true` for dotfiles.',
     inputSchema: SearchContentInputSchema,
     outputSchema: SearchContentOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,
     nuances: [
-        'Inline match rows are capped (first 50); full structured results are externalized via `resourceUri`.',
+        'Inline results capped at 50 matches; full results via `resourceUri`.',
         'Skips binary and oversized files.',
     ],
     gotchas: [
-        'Skips binary and oversized files silently — check file type with `stat` if no matches appear.',
+        'Skips binary/oversized files silently — verify with `stat` if no matches.',
     ],
     taskSupport: 'optional',
 };

package/dist/tools/search-files.js

@@ -1,18 +1,16 @@
 import * as path from 'node:path';
-import { formatOperationSummary, joinLines } from '../config.js';
 import { DEFAULT_EXCLUDE_PATTERNS, DEFAULT_SEARCH_TIMEOUT_MS, } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
-import { searchFiles } from '../lib/file-operations/search-files.js';
+import { searchFiles } from '../lib/file-operations/search.js';
+import { formatOperationSummary, joinLines } from '../config.js';
 import { SearchFilesInputSchema, SearchFilesOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, createProgressReporter, decodeOffsetCursor, encodeOffsetCursor, executeToolWithDiagnostics, notifyProgress, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const SEARCH_FILES_TOOL = {
     name: 'find',
     title: 'Find Files',
-    description: 'Find files by glob pattern (e.g., **/*.ts). ' +
-        'Returns a list of matching files with metadata. ' +
-        'For text search inside files, use grep. ' +
-        'To bulk-edit the matched files, pass the same glob pattern to search_and_replace.',
+    description: 'Find files by glob pattern (e.g. `**/*.ts`). Returns matching files with metadata. ' +
+        'For content search, use `grep`. For bulk edits, pass the same glob to `search_and_replace`.',
     inputSchema: SearchFilesInputSchema,
     outputSchema: SearchFilesOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/shared.d.ts

@@ -1,8 +1,8 @@
 import type { ContentBlock, Icon, ProgressNotificationParams } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
-import type { FileInfo } from '../config.js';
 import { ErrorCode } from '../lib/errors.js';
 import type { ResourceStore } from '../lib/resource-store.js';
+import type { FileInfo } from '../config.js';
 export { type ToolContract } from './contract.js';
 export declare const READ_ONLY_TOOL_ANNOTATIONS: {
     readonly readOnlyHint: true;
@@ -12,6 +12,7 @@ export declare const READ_ONLY_TOOL_ANNOTATIONS: {
 };
 export declare const DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS: {
     readonly readOnlyHint: false;
+    readonly idempotentHint: false;
     readonly destructiveHint: true;
     readonly openWorldHint: false;
 };

package/dist/tools/shared.js

@@ -5,7 +5,7 @@ import { parseTrueEnvFlag } from '../lib/constants.js';
 import { createDetailedError, ErrorCode, formatDetailedError, getSuggestion, McpError, } from '../lib/errors.js';
 import { createTimedAbortSignal } from '../lib/fs-helpers.js';
 import { withToolDiagnostics } from '../lib/observability.js';
-import { getAllowedDirectories } from '../lib/path-validation.js';
+import { getAllowedDirectories } from '../lib/paths.js';
 export {} from './contract.js';
 const MAX_INLINE_CONTENT_CHARS = parseInt(process.env['FS_CONTEXT_MAX_INLINE_CHARS'] ?? '', 10) || 20_000;
 const MAX_INLINE_PREVIEW_CHARS = 4_000;
@@ -24,6 +24,7 @@ export const READ_ONLY_TOOL_ANNOTATIONS = {
 };
 export const DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS = {
     readOnlyHint: false,
+    idempotentHint: false,
     destructiveHint: true,
     openWorldHint: false,
 };

package/dist/tools/stat-many.js

@@ -1,14 +1,15 @@
-import { formatBytes, joinLines } from '../config.js';
 import { DEFAULT_SEARCH_TIMEOUT_MS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
-import { getMultipleFileInfo } from '../lib/file-operations/file-info.js';
+import { getMultipleFileInfo } from '../lib/file-operations/metadata.js';
+import { formatBytes, joinLines } from '../config.js';
 import { GetMultipleFileInfoInputSchema, GetMultipleFileInfoOutputSchema, } from '../schemas.js';
 import { buildBatchCompletionSuffix, buildBatchPathContext, buildFileInfoPayload, buildToolErrorResponse, buildToolResponse, createBatchProgressCallbacks, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, resolveFinalProgressCurrent, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const GET_MULTIPLE_FILE_INFO_TOOL = {
     name: 'stat_many',
     title: 'Get Multiple File Info',
-    description: 'Get metadata (including tokenEstimate) for multiple files or directories in one request. Use tokenEstimate (size÷4) to pre-screen token cost before reading.',
+    description: 'Get metadata for multiple files/directories in one request. ' +
+        'Use `tokenEstimate` (size\u00f74) to pre-screen token cost before reading.',
     inputSchema: GetMultipleFileInfoInputSchema,
     outputSchema: GetMultipleFileInfoOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/stat.js

@@ -1,14 +1,15 @@
 import * as path from 'node:path';
-import { formatBytes, joinLines } from '../config.js';
 import { DEFAULT_SEARCH_TIMEOUT_MS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
-import { getFileInfo } from '../lib/file-operations/file-info.js';
+import { getFileInfo } from '../lib/file-operations/metadata.js';
+import { formatBytes, joinLines } from '../config.js';
 import { GetFileInfoInputSchema, GetFileInfoOutputSchema } from '../schemas.js';
 import { buildFileInfoPayload, buildToolErrorResponse, buildToolResponse, executeToolWithDiagnostics, READ_ONLY_TOOL_ANNOTATIONS, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 export const GET_FILE_INFO_TOOL = {
     name: 'stat',
     title: 'Get File Info',
-    description: 'Get metadata (size, modified time, permissions, mime type, tokenEstimate) for a file or directory. Use tokenEstimate (size÷4) to pre-screen token cost before reading.',
+    description: 'Get file/directory metadata: size, modified, permissions, mime, tokenEstimate. ' +
+        'Use `tokenEstimate` (size\u00f74) to pre-screen token cost before reading.',
     inputSchema: GetFileInfoInputSchema,
     outputSchema: GetFileInfoOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/task-support.js

@@ -1,7 +1,7 @@
 import { channel } from 'node:diagnostics_channel';
 import { CallToolResultSchema } from '@modelcontextprotocol/sdk/types.js';
 import { ErrorCode, McpError } from '../lib/errors.js';
-import { isRecord } from '../lib/type-guards.js';
+import { isRecord } from '../lib/utils.js';
 import { buildToolErrorResponse, maybeStripStructuredContentFromResult, withDefaultIcons, } from './shared.js';
 function isExperimentalTaskRegistration(value) {
     if (!value || typeof value !== 'object')

package/dist/tools/tree.js

@@ -1,16 +1,15 @@
 import * as path from 'node:path';
 import { DEFAULT_SEARCH_TIMEOUT_MS } from '../lib/constants.js';
 import { ErrorCode } from '../lib/errors.js';
-import { formatTreeAscii, treeDirectory } from '../lib/file-operations/tree.js';
+import { formatTreeAscii, treeDirectory, } from '../lib/file-operations/metadata.js';
 import { TreeInputSchema, TreeOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, createProgressReporter, executeToolWithDiagnostics, notifyProgress, READ_ONLY_TOOL_ANNOTATIONS, resolvePathOrRoot, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';
 export const TREE_TOOL = {
     name: 'tree',
     title: 'Tree',
-    description: 'Render a directory tree (bounded recursion). ' +
-        'Returns an ASCII tree for quick scanning and a structured JSON tree for programmatic use. ' +
-        'Note: maxDepth=0 returns only the root node with empty children array.',
+    description: 'Render a directory tree (bounded recursion). Returns ASCII tree + structured JSON. ' +
+        '`maxDepth=0` returns only the root node.',
     inputSchema: TreeInputSchema,
     outputSchema: TreeOutputSchema,
     annotations: READ_ONLY_TOOL_ANNOTATIONS,

package/dist/tools/write-file.js

@@ -2,7 +2,7 @@ import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { ErrorCode } from '../lib/errors.js';
 import { atomicWriteFile, withAbort } from '../lib/fs-helpers.js';
-import { validatePathForWrite } from '../lib/path-validation.js';
+import { validatePathForWrite } from '../lib/paths.js';
 import { WriteFileInputSchema, WriteFileOutputSchema } from '../schemas.js';
 import { buildToolErrorResponse, buildToolResponse, DESTRUCTIVE_WRITE_TOOL_ANNOTATIONS, executeToolWithDiagnostics, withDefaultIcons, withValidatedArgs, wrapToolHandler, } from './shared.js';
 import { registerToolTaskIfAvailable } from './task-support.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/filesystem-mcp",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "mcpName": "io.github.j0hanz/filesystem-mcp",
   "description": "MCP Server that enables LLMs to interact with the local filesystem.",
   "type": "module",
@@ -68,7 +68,7 @@
     "commander": "^14.0.3",
     "diff": "^8.0.3",
     "ignore": "^7.0.5",
-    "re2": "^1.23.2",
+    "re2": "^1.23.3",
     "safe-regex2": "^5.0.0",
     "zod": "^4.3.6"
   },
@@ -78,8 +78,8 @@
     "@types/node": "^24",
     "eslint": "^10.0.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-de-morgan": "^2.0.0",
-    "eslint-plugin-depend": "^1.4.0",
+    "eslint-plugin-de-morgan": "^2.1.1",
+    "eslint-plugin-depend": "^1.5.0",
     "eslint-plugin-sonarjs": "^4.0.0",
     "eslint-plugin-unused-imports": "^4.4.1",
     "jscpd": "^4.0.8",

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

@@ -1,10 +0,0 @@
-import type { FileInfo, GetMultipleFileInfoResult } from '../../config.js';
-interface FileInfoOptions {
-    includeMimeType?: boolean | undefined;
-    signal?: AbortSignal | undefined;
-    onProgress?: () => void;
-}
-export declare function getFileInfo(filePath: string, options?: FileInfoOptions): Promise<FileInfo>;
-type GetMultipleFileInfoOptions = FileInfoOptions;
-export declare function getMultipleFileInfo(paths: readonly string[], options?: GetMultipleFileInfoOptions): Promise<GetMultipleFileInfoResult>;
-export {};

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

@@ -1,143 +0,0 @@
-import * as fsp from 'node:fs/promises';
-import * as path from 'node:path';
-import { getMimeType, PARALLEL_CONCURRENCY } from '../constants.js';
-import { isAbortError } from '../errors.js';
-import { assertNotAborted, getFileType, isHidden, processInParallel, withAbort, } from '../fs-helpers.js';
-import { assertAllowedFileAccess } from '../path-policy.js';
-import { validateExistingPathDetailed } from '../path-validation.js';
-import { applyIndexedErrors, applyIndexedValues } from './common.js';
-const PERM_STRINGS = [
-    '---',
-    '--x',
-    '-w-',
-    '-wx',
-    'r--',
-    'r-x',
-    'rw-',
-    'rwx',
-];
-const UNKNOWN_PATH = '(unknown)';
-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 buildFileInfoResult(name, requestedPath, isSymlink, stats, mimeType, symlinkTarget) {
-    const tokenEstimate = stats.isFile() ? Math.ceil(stats.size / 4) : undefined;
-    return {
-        name,
-        path: requestedPath,
-        type: isSymlink ? 'symlink' : getFileType(stats),
-        size: stats.size,
-        ...(tokenEstimate !== undefined ? { tokenEstimate } : {}),
-        created: stats.birthtime,
-        modified: stats.mtime,
-        accessed: stats.atime,
-        permissions: getPermissions(stats.mode),
-        isHidden: isHidden(name),
-        ...(mimeType !== undefined ? { mimeType } : {}),
-        ...(symlinkTarget !== undefined ? { symlinkTarget } : {}),
-    };
-}
-async function getSymlinkTarget(pathToRead, signal) {
-    assertNotAborted(signal);
-    try {
-        return await withAbort(fsp.readlink(pathToRead), signal);
-    }
-    catch (error) {
-        if (isAbortError(error))
-            throw error;
-        return undefined;
-    }
-}
-export async function getFileInfo(filePath, options = {}) {
-    const { signal } = options;
-    assertNotAborted(signal);
-    const { requestedPath, resolvedPath, isSymlink } = await validateExistingPathDetailed(filePath, signal);
-    assertAllowedFileAccess(requestedPath, resolvedPath);
-    const name = path.basename(requestedPath);
-    const ext = path.extname(name).toLowerCase();
-    const includeMimeType = options.includeMimeType !== false;
-    const mimeType = includeMimeType && ext.length > 0 ? getMimeType(ext) : undefined;
-    const symlinkTarget = isSymlink
-        ? await getSymlinkTarget(requestedPath, signal)
-        : undefined;
-    const stats = await withAbort(fsp.stat(resolvedPath), signal);
-    return buildFileInfoResult(name, requestedPath, isSymlink, stats, mimeType, symlinkTarget);
-}
-function buildEmptyResult() {
-    return {
-        results: [],
-        summary: { total: 0, succeeded: 0, failed: 0, totalSize: 0 },
-    };
-}
-async function processFileInfo(filePath, options) {
-    const info = await getFileInfo(filePath, options);
-    return { path: filePath, info };
-}
-function buildIndexedPathTasks(paths) {
-    const tasks = [];
-    for (let index = 0; index < paths.length; index += 1) {
-        const filePath = paths[index];
-        if (filePath === undefined)
-            continue;
-        tasks.push({ filePath, index });
-    }
-    return tasks;
-}
-async function readFileInfoInParallel(paths, options) {
-    return processInParallel(buildIndexedPathTasks(paths), async ({ filePath, index }) => {
-        const value = await processFileInfo(filePath, options);
-        options.onProgress?.();
-        return { index, value };
-    }, PARALLEL_CONCURRENCY, options.signal);
-}
-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 = new Array(paths.length);
-    for (let index = 0; index < paths.length; index += 1) {
-        output[index] = { path: paths[index] ?? UNKNOWN_PATH };
-    }
-    const { results, errors } = await readFileInfoInParallel(paths, options);
-    applyIndexedValues(output, results);
-    applyIndexedErrors({
-        output,
-        errors,
-        resolveIndex: (failureIndex) => failureIndex >= 0 && failureIndex < output.length
-            ? failureIndex
-            : undefined,
-        buildValue: (resolvedIndex, error) => ({
-            path: paths[resolvedIndex] ?? UNKNOWN_PATH,
-            error: error.message,
-        }),
-    });
-    return {
-        results: output,
-        summary: calculateSummary(output),
-    };
-}

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

@@ -1,6 +0,0 @@
-import { type Ignore } from 'ignore';
-export declare function loadRootGitignore(root: string, signal?: AbortSignal): Promise<Ignore | null>;
-export declare function isIgnoredByGitignore(matcher: Ignore, root: string, absolutePath: string, options?: {
-    isDirectory?: boolean;
-    relativePath?: string;
-}): boolean;