Roadmap

Roadmap: MCP Filesystem Ultra

Last updated: March 2026 Current version: v4.1.0 Go version: 1.26.0 Status: Production-ready

Current Version: v4.1.0

Tool Inventory (16 tools)

CORE (5):      read_file, write_file, edit_file, list_directory, search_files
EDIT+ (1):     multi_edit
FILES (4):     move_file, copy_file, delete_file, create_directory
BATCH (1):     batch_operations  (pipelines + batch rename)
BACKUP (1):    backup            (restore via action:"restore")
ANALYSIS (1):  analyze_operation (file, optimize, write, edit, delete, compare)
WSL (1):       wsl               (sync + status via action param)
UTIL (1):      server_info       (help, stats, artifact via action param)
INFO (1):      get_file_info

Consolidated from 59 tools in v3.x. All engine functions unchanged; only the MCP tool surface was restructured.

Pipeline System (12 actions)

Action	Type	Description
`search`	Read	Search files by pattern
`read_ranges`	Read	Read file contents
`count_occurrences`	Read	Count pattern occurrences
`edit`	Write	Search-and-replace
`multi_edit`	Write	Multiple edits per file
`regex_transform`	Write	Regex with capture groups
`copy`	Write	Copy files
`rename`	Write	Rename/move files
`delete`	Write	Soft-delete files
`aggregate`	Meta	Combine content from steps
`diff`	Meta	Unified diff between files
`merge`	Meta	Union/intersection of file lists

Features: conditional steps (9 condition types), template variables ({{step_id.field}}), DAG-based parallel execution, structured error reporting.

Metrics

Metric	Value
MCP Tools	16 (consolidated from 59)
Pipeline Actions	12
Normalizer Rules	14 built-in
CVEs resolved (Go toolchain)	8
Security vulnerabilities fixed	13 (5 Critical + 3 High + 5 Medium)
Bugs fixed	23
Passing tests	100+

Recent Releases

Version	Date	Theme
v4.1.0	2026-03-06	Pipeline System v2 (12 actions, conditions, templates, parallel)
v4.0.2	2026-03-16	Self-Learning Normalizer (14 rules) + Bug #23 CRLF fix
v4.0.1	2026-03-04	Bug #18-21 hotfixes
v4.0.0	2026-03-03	Tool Consolidation (59 → 16) + MCP spec annotations
v3.16.0	2026-02	Bug #17 multi_edit verification + EditFile parity
v3.15.1	2026-02	Bug #16 edit risk model — only CRITICAL blocks
v3.15.0	2026-02	Performance (cached AllowedPaths, regex cache, O(1) text detection)
v3.14.5	2026-02	Bug #15 mcp_edit force:true
v3.14.0	2026-02	Pipeline Transformation System v1
v3.13.0	2026-01-31	Security Audit (13 fixes, crypto/rand, symlink protection)
v3.12.0	2025-12	Coordinate tracking in search results
v3.11.0	2025-12-21	Performance & Modernization (slog, custom errors, bufio.Scanner)

See Changelog for full details.

Completed Features

Core Operations

Read/write/edit files with automatic I/O strategy selection based on file size
Streaming writes and chunked reads for large files
Range reads (start_line/end_line), base64 encoding
Multi-edit with per-edit status tracking

Search

Regex and literal search with content, file type, and context filters
Count occurrences (count_only: true)
Character-level coordinate tracking

Editing

Intelligent edit with multi-level fallback matching
Search-and-replace mode, nth occurrence replacement
Regex transformations with capture groups
Risk assessment (LOW/MEDIUM/HIGH/CRITICAL)
Edit safety validation with context checks

Batch & Pipelines

12-action pipeline system with step chaining (input_from)
Conditional steps, template variables, parallel execution
Batch rename with preview mode
Automatic backup and rollback on failure

Backup System

Automatic backup before edits
Restore, compare, list, cleanup via unified backup tool
Dashboard with enterprise search/filter/recovery UI

WSL Integration

Bidirectional WSL/Windows path conversion
Workspace sync, auto-sync configuration
NormalizePath() on all tool handlers

Security

Go 1.26.0 (8 CVEs resolved in stdlib)
13 vulnerability fixes (symlink traversal, access control, TOCTOU)
crypto/rand for all temp files and backup IDs
Backup ID sanitization against path traversal

Observability

Audit logging (--log-dir) with JSON Lines rotation
Dashboard binary with real-time SSE updates
Normalizer stats and error pattern tracking
Per-step pipeline progress in dashboard

Pending Improvements

Diff-based editing (send only changes instead of full content)
AST-aware code search (functions, variables, types)
Tool titles with WithTitleAnnotation() (MCP 2025-11-25 optional)
Output schemas for structured tool results (MCP 2025-11-25 optional)
Test coverage increase (currently ~25%, target 50%+)

Evolution

Tool Count

v2.0.0  ████████░░ (32 tools)
v3.7.0  █████████░ (50 tools)
v3.13.2 █████████░ (56 tools)
v4.0.0  ████░░░░░░ (16 tools, consolidated)  ← Current

Security

v3.8.0  ████░░░░░░ (Risk assessment, backups)
v3.10.0 ███████░░░ (Edit safety layer)
v3.13.0 ██████████ (Full audit, 13 fixes, crypto/rand)

Architectural Decisions

Maintain

MCP protocol 2025-11-25 compliant (mcp-go v0.43.2)
BigCache for file content caching (3-tier cache)
ants/v2 worker pool for concurrency
crypto/rand for secure ID generation
Windows/WSL compatibility layer

Completed

Custom error types with Go 1.13+ wrapping (v3.11.0)
slog structured logging (v3.11.0)
Full security audit with 13 fixes (v3.13.0)
Tool consolidation 59 → 16 (v4.0.0)
Self-Learning Normalizer (v4.0.2)
Pipeline System v2 with 12 actions (v4.1.0)

How to Contribute

Report issues as GitHub issues
Feature requests with: use case, expected impact, estimated effort
Security issues through Security Policy

Maintained By: David Prats