@j0hanz/filesystem-context-mcp 1.0.4 → 1.0.7

package/dist/prompts/filesystem-query.js

@@ -0,0 +1,168 @@
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { z } from 'zod';
+import { DEFAULT_EXCLUDES, pathCompleter } from './shared.js';
+const OPERATIONS = {
+    explore: {
+        tools: `1. \`directory_tree\` maxDepth={depth} excludePatterns={excludes} → hierarchy
+2. \`analyze_directory\` excludePatterns={excludes} → stats
+3. \`list_directory\` sortBy="modified" → recent activity`,
+        deliverables: `- Structure overview & folder purposes
+- File distribution by type
+- Key config/entry files
+- Notable findings`,
+        requiresPattern: false,
+        usesDepth: true,
+    },
+    'find-files': {
+        tools: `1. \`search_files\` pattern="{pattern}" excludePatterns={excludes} maxResults=100 → find matches
+2. \`read_multiple_files\` → batch examine contents
+3. \`get_file_info\` → metadata if needed`,
+        deliverables: `- Matched files with sizes (up to 100 results)
+- Content summary of key files
+- Related pattern suggestions`,
+        requiresPattern: true,
+        usesDepth: true,
+        maxResults: 100,
+    },
+    'search-code': {
+        tools: `1. \`search_content\` pattern="{pattern}" contextLines=2 maxResults=50 excludePatterns={excludes} → find matches
+2. \`read_multiple_files\` → batch read for full context`,
+        deliverables: `- Match count & files affected (up to 50 matches)
+- Key matches with surrounding context
+- Pattern usage analysis
+- Suggested refactoring if duplicates found`,
+        requiresPattern: true,
+        usesDepth: false,
+        maxResults: 50,
+    },
+    'analyze-size': {
+        tools: `1. \`analyze_directory\` maxDepth={depth} excludePatterns={excludes} → size stats
+2. \`directory_tree\` includeSize=true maxDepth={depth} excludePatterns={excludes} → visualize
+3. \`search_files\` sortBy="size" maxResults=20 → largest files`,
+        deliverables: `- Total size & file counts
+- Top 10 largest files with paths
+- Size breakdown by extension
+- Cleanup suggestions (large/unused files)`,
+        requiresPattern: false,
+        usesDepth: true,
+    },
+    'recent-changes': {
+        tools: `1. \`analyze_directory\` maxDepth={depth} excludePatterns={excludes} → recentlyModified
+2. \`list_directory\` sortBy="modified" recursive=true maxDepth={depth}
+3. \`read_multiple_files\` → batch examine recent files`,
+        deliverables: `- Recent activity timeline (last 24h, 7d, 30d)
+- Most active directories
+- Change patterns & hot spots
+- Files to review`,
+        requiresPattern: false,
+        usesDepth: true,
+    },
+};
+export function registerFilesystemQueryPrompt(server) {
+    server.registerPrompt('filesystem-query', {
+        description: 'Guided filesystem operations: explore, find, search, size, changes',
+        argsSchema: {
+            path: completable(z.string().min(1).describe('Target path'), pathCompleter),
+            operation: z
+                .enum([
+                'explore',
+                'find-files',
+                'search-code',
+                'analyze-size',
+                'recent-changes',
+            ])
+                .describe('Operation type'),
+            pattern: z
+                .string()
+                .optional()
+                .describe('Search pattern (glob for find-files, regex for search-code)'),
+            depth: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .optional()
+                .default(5)
+                .describe('Max depth (1-20, default: 5)'),
+            caseSensitive: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Case-sensitive search (search-code only)'),
+        },
+    }, ({ path, operation, pattern, depth, caseSensitive }) => {
+        const config = OPERATIONS[operation];
+        // Type guard - should never happen with enum validation, but TypeScript needs this
+        if (!config) {
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Unknown operation: "${operation}". Valid operations: ${Object.keys(OPERATIONS).join(', ')}`,
+                        },
+                    },
+                ],
+            };
+        }
+        const excludesJson = JSON.stringify(DEFAULT_EXCLUDES);
+        // Validate pattern requirement
+        if (config.requiresPattern && !pattern) {
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `⚠️ The "${operation}" operation requires a pattern.
+
+Please provide:
+- For **find-files**: a glob pattern (e.g., "**/*.ts", "src/**/*.json")
+- For **search-code**: a regex pattern (e.g., "TODO|FIXME", "function\\s+\\w+")`,
+                        },
+                    },
+                ],
+            };
+        }
+        // Build tools section with substitutions
+        const tools = config.tools
+            .replace(/{depth}/g, String(depth))
+            .replace(/{excludes}/g, excludesJson)
+            .replace(/{pattern}/g, pattern ?? '*');
+        // Build search options for search-code
+        const searchOptions = operation === 'search-code'
+            ? ` caseSensitive=${String(caseSensitive)}`
+            : '';
+        const patternInfo = pattern ? ` pattern="${pattern}"` : '';
+        const depthInfo = config.usesDepth ? ` maxDepth=${String(depth)}` : '';
+        const promptText = `**${operation.charAt(0).toUpperCase() + operation.slice(1)}** "${path}"${patternInfo}${depthInfo}${searchOptions}
+
+⚠️ First run \`list_allowed_directories\` to verify path is accessible.
+
+**Default excludes:** ${DEFAULT_EXCLUDES.join(', ')}
+
+**Tools:**
+${tools}
+
+**Deliverables:**
+${config.deliverables}
+
+**Best Practices:**
+- Use \`read_multiple_files\` to batch read (more efficient than sequential reads)
+- Stop early if results are sufficient
+- Report any inaccessible paths encountered`;
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: promptText,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=filesystem-query.js.map

package/dist/prompts/filesystem-query.js.map

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

package/dist/prompts/find-duplicates.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerFindDuplicatesPrompt(server: McpServer): void;
+//# sourceMappingURL=find-duplicates.d.ts.map

package/dist/prompts/find-duplicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-duplicates.d.ts","sourceRoot":"","sources":["../../src/prompts/find-duplicates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgFpE"}

package/dist/prompts/find-duplicates.js

@@ -0,0 +1,77 @@
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { z } from 'zod';
+import { DEFAULT_EXCLUDES, pathCompleter } from './shared.js';
+// Extended excludes for duplicate scanning (adds minified/bundled files to base excludes)
+const DUPLICATE_EXCLUDES = [...DEFAULT_EXCLUDES, '*.min.js', '*.bundle.js'];
+export function registerFindDuplicatesPrompt(server) {
+    server.registerPrompt('find-duplicates', {
+        description: 'Find duplicate code, similar patterns, and refactoring opportunities',
+        argsSchema: {
+            path: completable(z.string().min(1).describe('Root path to search'), pathCompleter),
+            pattern: z
+                .string()
+                .optional()
+                .default('**/*.{ts,js,tsx,jsx,py,java}')
+                .describe('Source file glob pattern'),
+            searchTerm: z
+                .string()
+                .optional()
+                .describe('Specific function/pattern to find duplicates of'),
+            minLines: z
+                .number()
+                .int()
+                .min(2)
+                .max(50)
+                .optional()
+                .default(5)
+                .describe('Minimum lines to consider as duplicate (default: 5)'),
+        },
+    }, ({ path, pattern, searchTerm, minLines }) => {
+        const excludePatterns = JSON.stringify(DUPLICATE_EXCLUDES);
+        const searchInstructions = searchTerm
+            ? `\`search_content\` pattern="${searchTerm}" contextLines=2 → find all occurrences`
+            : `\`search_content\` → find duplicates using these patterns:
+- Function signatures: \`(export )?(async )?(function|const)\\s+\\w+\`
+- Import blocks: \`^import .+ from\`
+- Error handlers: \`catch\\s*\\(\` or \`\\.catch\\(\`
+- Repeated utility patterns: loops, conditionals, API calls`;
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Find duplicate code in "${path}".
+
+⚠️ First run \`list_allowed_directories\` to verify path is accessible.
+
+**Workflow:**
+1. \`search_files\` pattern="${pattern}" excludePatterns=${excludePatterns}
+2. \`analyze_directory\` excludePatterns=${excludePatterns} → identify similar-sized files (potential copies)
+3. ${searchInstructions}
+4. \`read_multiple_files\` → batch compare suspect files
+
+**Duplicate Detection Criteria (minimum ${minLines} lines):**
+- Code blocks that are character-for-character identical
+- Code with only variable/parameter name differences
+- Structural duplicates: same logic, different formatting
+
+**Report Format:**
+| Category | Description |
+|----------|-------------|
+| **Exact duplicates** | Identical code blocks with file:line locations |
+| **Near duplicates** | 80%+ similar code, highlight differences |
+| **Extractable patterns** | Repeated logic → shared utility/hook candidates |
+| **Refactoring plan** | Priority order, files affected, breaking change risks |
+
+**For each duplicate found, provide:**
+1. File locations (all occurrences)
+2. Code snippet (first occurrence)
+3. Suggested abstraction (function name, module location)`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=find-duplicates.js.map

package/dist/prompts/find-duplicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-duplicates.js","sourceRoot":"","sources":["../../src/prompts/find-duplicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAG9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,0FAA0F;AAC1F,MAAM,kBAAkB,GAAG,CAAC,GAAG,gBAAgB,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAE5E,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,WAAW,EACT,sEAAsE;QACxE,UAAU,EAAE;YACV,IAAI,EAAE,WAAW,CACf,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EACjD,aAAa,CACd;YACD,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,8BAA8B,CAAC;iBACvC,QAAQ,CAAC,0BAA0B,CAAC;YACvC,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,OAAO,CAAC,CAAC,CAAC;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;KACF,EACD,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC1C,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAE3D,MAAM,kBAAkB,GAAG,UAAU;YACnC,CAAC,CAAC,+BAA+B,UAAU,yCAAyC;YACpF,CAAC,CAAC;;;;4DAIkD,CAAC;QAEvD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2BAA2B,IAAI;;;;;+BAKpB,OAAO,qBAAqB,eAAe;2CAC/B,eAAe;KACrD,kBAAkB;;;0CAGmB,QAAQ;;;;;;;;;;;;;;;;0DAgBQ;qBAC7C;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAllPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAM1D"}

package/dist/prompts/index.js

@@ -0,0 +1,13 @@
+import { registerAnalyzeCodebasePrompt } from './analyze-codebase.js';
+import { registerFilesystemQueryPrompt } from './filesystem-query.js';
+import { registerFindDuplicatesPrompt } from './find-duplicates.js';
+import { registerProjectOverviewPrompt } from './project-overview.js';
+import { registerSearchAndReplacePrompt } from './search-and-replace.js';
+export function registerAllPrompts(server) {
+    registerProjectOverviewPrompt(server);
+    registerAnalyzeCodebasePrompt(server);
+    registerFindDuplicatesPrompt(server);
+    registerSearchAndReplacePrompt(server);
+    registerFilesystemQueryPrompt(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,6BAA6B,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/prompts/project-overview.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectOverviewPrompt(server: McpServer): void;
+//# sourceMappingURL=project-overview.d.ts.map

package/dist/prompts/project-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-overview.d.ts","sourceRoot":"","sources":["../../src/prompts/project-overview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4CzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+FrE"}

package/dist/prompts/project-overview.js

@@ -0,0 +1,122 @@
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { z } from 'zod';
+import { DEFAULT_EXCLUDES, pathCompleter } from './shared.js';
+// Extended excludes for project overview (adds framework-specific dirs)
+const PROJECT_EXCLUDES = [...DEFAULT_EXCLUDES, '.next/**', '.nuxt/**'];
+// Config files to look for by category
+const CONFIG_FILES = {
+    project: [
+        'package.json',
+        'pyproject.toml',
+        'Cargo.toml',
+        'go.mod',
+        'pom.xml',
+        'build.gradle',
+    ],
+    typescript: ['tsconfig.json', 'jsconfig.json'],
+    build: [
+        'vite.config.*',
+        'webpack.config.*',
+        'rollup.config.*',
+        'next.config.*',
+        'nuxt.config.*',
+    ],
+    lint: ['.eslintrc*', 'eslint.config.*', '.prettierrc*', 'biome.json'],
+    docker: ['Dockerfile', 'docker-compose.yml', 'docker-compose.yaml'],
+    ci: ['.github/workflows/*.yml', '.gitlab-ci.yml'],
+    docs: ['README.md', 'CHANGELOG.md', 'CONTRIBUTING.md', 'LICENSE'],
+    env: ['.env.example', '.env.sample', '.env.template'],
+};
+// Build flat list of priority config files for the prompt
+function getConfigFileList() {
+    return Object.entries(CONFIG_FILES)
+        .map(([category, files]) => `- **${category}**: ${files.slice(0, 3).join(', ')}`)
+        .join('\n');
+}
+export function registerProjectOverviewPrompt(server) {
+    server.registerPrompt('project-overview', {
+        description: 'Quick overview of project structure, tech stack, and key files',
+        argsSchema: {
+            path: completable(z.string().min(1).describe('Project root path'), pathCompleter),
+            depth: z
+                .number()
+                .int()
+                .min(1)
+                .max(10)
+                .optional()
+                .default(4)
+                .describe('Tree depth (1-10, default: 4)'),
+            includeCI: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Include CI/CD config analysis'),
+        },
+    }, ({ path, depth, includeCI }) => {
+        const excludesJson = JSON.stringify(PROJECT_EXCLUDES);
+        const configList = getConfigFileList();
+        // Priority files to always try reading
+        const priorityFiles = [
+            'package.json',
+            'README.md',
+            'tsconfig.json',
+            ...(includeCI ? ['.github/workflows/*.yml'] : []),
+        ];
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Analyze project at "${path}".
+
+⚠️ First run \`list_allowed_directories\` to verify path is accessible.
+
+**Default excludes:** ${PROJECT_EXCLUDES.slice(0, 4).join(', ')}
+
+**Workflow:**
+1. \`directory_tree\` maxDepth=${String(depth)} excludePatterns=${excludesJson} → structure
+2. \`search_files\` pattern="*config*|*.json|*.toml|*.yml" excludePatterns=${excludesJson} → find config files
+3. \`analyze_directory\` excludePatterns=${excludesJson} → stats & largest files
+4. \`read_multiple_files\` → batch read found configs (priority: ${priorityFiles.join(', ')})
+
+**Config files to look for:**
+${configList}
+
+**Deliverables:**
+
+| Section | Details |
+|---------|---------|
+| **Tech Stack** | Languages, frameworks, runtime versions |
+| **Package Manager** | npm/yarn/pnpm + lock file present |
+| **Build System** | Bundler, compiler, scripts |
+| **Folder Structure** | src/, lib/, tests/ conventions |
+| **Entry Points** | main, bin, exports in package.json |
+| **Dependencies** | Key deps vs devDeps, outdated indicators |
+| **Code Quality** | Linting, formatting, type checking setup |
+${includeCI ? '| **CI/CD** | Workflows, test/deploy pipelines |' : ''}
+
+**Output Format:**
+\`\`\`
+## Project: {name}
+**Type**: {monorepo|library|application|cli}
+**Stack**: {languages} + {frameworks}
+**Build**: {tool} → {output}
+
+### Structure
+{tree summary}
+
+### Key Findings
+- {finding 1}
+- {finding 2}
+
+### Recommendations
+- {recommendation if any}
+\`\`\``,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=project-overview.js.map

package/dist/prompts/project-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-overview.js","sourceRoot":"","sources":["../../src/prompts/project-overview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAG9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,CAAC,GAAG,gBAAgB,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAEvE,uCAAuC;AACvC,MAAM,YAAY,GAA6B;IAC7C,OAAO,EAAE;QACP,cAAc;QACd,gBAAgB;QAChB,YAAY;QACZ,QAAQ;QACR,SAAS;QACT,cAAc;KACf;IACD,UAAU,EAAE,CAAC,eAAe,EAAE,eAAe,CAAC;IAC9C,KAAK,EAAE;QACL,eAAe;QACf,kBAAkB;QAClB,iBAAiB;QACjB,eAAe;QACf,eAAe;KAChB;IACD,IAAI,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,CAAC;IACrE,MAAM,EAAE,CAAC,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,CAAC;IACnE,EAAE,EAAE,CAAC,yBAAyB,EAAE,gBAAgB,CAAC;IACjD,IAAI,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,SAAS,CAAC;IACjE,GAAG,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,eAAe,CAAC;CACtD,CAAC;AAEF,0DAA0D;AAC1D,SAAS,iBAAiB;IACxB,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SAChC,GAAG,CACF,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CACpB,OAAO,QAAQ,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,cAAc,CACnB,kBAAkB,EAClB;QACE,WAAW,EACT,gEAAgE;QAClE,UAAU,EAAE;YACV,IAAI,EAAE,WAAW,CACf,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAC/C,aAAa,CACd;YACD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,OAAO,CAAC,CAAC,CAAC;iBACV,QAAQ,CAAC,+BAA+B,CAAC;YAC5C,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,+BAA+B,CAAC;SAC7C;KACF,EACD,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;QAEvC,uCAAuC;QACvC,MAAM,aAAa,GAAG;YACpB,cAAc;YACd,WAAW;YACX,eAAe;YACf,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,IAAI;;;;wBAIvB,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;iCAG9B,MAAM,CAAC,KAAK,CAAC,oBAAoB,YAAY;6EACD,YAAY;2CAC9C,YAAY;mEACY,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGzF,UAAU;;;;;;;;;;;;;EAaV,SAAS,CAAC,CAAC,CAAC,kDAAkD,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;OAkB9D;qBACM;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/search-and-replace.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchAndReplacePrompt(server: McpServer): void;
+//# sourceMappingURL=search-and-replace.d.ts.map

package/dist/prompts/search-and-replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-and-replace.d.ts","sourceRoot":"","sources":["../../src/prompts/search-and-replace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkJtE"}

package/dist/prompts/search-and-replace.js

@@ -0,0 +1,130 @@
+import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
+import { z } from 'zod';
+import { DEFAULT_EXCLUDES, pathCompleter } from './shared.js';
+// Extended excludes for search-and-replace (adds lock/minified files)
+const SEARCH_REPLACE_EXCLUDES = [...DEFAULT_EXCLUDES, '*.lock', '*.min.js'];
+export function registerSearchAndReplacePrompt(server) {
+    server.registerPrompt('search-and-replace-plan', {
+        description: 'Plan search & replace with impact analysis and safety categorization (read-only analysis)',
+        argsSchema: {
+            path: completable(z.string().min(1).describe('Root path to search'), pathCompleter),
+            searchPattern: z
+                .string()
+                .min(1)
+                .describe('Search pattern (regex supported, use isLiteral=true for plain text)'),
+            replacement: z.string().describe('Replacement text'),
+            filePattern: z
+                .string()
+                .optional()
+                .default('**/*.{ts,js,tsx,jsx,py,java,go,rs,md,json}')
+                .describe('File glob pattern'),
+            caseSensitive: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Case sensitive match'),
+            wholeWord: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Match whole words only'),
+            isLiteral: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Treat search pattern as literal text (auto-escape regex chars)'),
+            maxResults: z
+                .number()
+                .int()
+                .min(1)
+                .max(500)
+                .optional()
+                .default(100)
+                .describe('Maximum matches to analyze (default: 100)'),
+        },
+    }, ({ path, searchPattern, replacement, filePattern, caseSensitive, wholeWord, isLiteral, maxResults, }) => {
+        const excludesJson = JSON.stringify(SEARCH_REPLACE_EXCLUDES);
+        // Build search options string
+        const searchOptions = [
+            `pattern="${searchPattern}"`,
+            `filePattern="${filePattern}"`,
+            `excludePatterns=${excludesJson}`,
+            'contextLines=2',
+            `maxResults=${maxResults}`,
+            `caseSensitive=${String(caseSensitive)}`,
+            `wholeWord=${String(wholeWord)}`,
+            `isLiteral=${String(isLiteral)}`,
+        ].join(' ');
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `**Search & Replace Analysis** for "${path}"
+
+⚠️ **READ-ONLY ANALYSIS** - This server cannot modify files. This prompt generates a replacement plan for manual execution or use with other tools.
+
+⚠️ First run \`list_allowed_directories\` to verify path is accessible.
+
+**Operation:**
+| Field | Value |
+|-------|-------|
+| Search | \`${searchPattern}\` |
+| Replace | \`${replacement}\` |
+| Files | \`${filePattern}\` |
+| Case-sensitive | ${String(caseSensitive)} |
+| Whole word | ${String(wholeWord)} |
+| Literal (no regex) | ${String(isLiteral)} |
+| Max results | ${maxResults} |
+
+**Default excludes:** ${SEARCH_REPLACE_EXCLUDES.slice(0, 4).join(', ')}
+
+**Workflow:**
+1. \`search_content\` ${searchOptions}
+2. \`read_multiple_files\` → batch examine files with complex matches
+
+**Categorize each match:**
+| Category | Criteria | Action |
+|----------|----------|--------|
+| ✅ **Safe** | Simple, isolated, no side effects | Auto-replaceable |
+| ⚠️ **Review** | In comments, strings, or complex context | Manual verification needed |
+| ❌ **Skip** | False positive, partial match, generated code | Do not replace |
+
+**Impact Analysis:**
+- API changes (function signatures, exports)
+- Import/require statements
+- Test files & assertions
+- Documentation & comments
+- Config files (may need special handling)
+
+**Deliverables:**
+
+1. **Summary Table:**
+| File | Matches | Safe | Review | Skip |
+|------|---------|------|--------|------|
+
+2. **Diff Preview** (for each match):
+\`\`\`diff
+- {original line with match highlighted}
++ {line after replacement}
+\`\`\`
+
+3. **Execution Plan:**
+- Phase 1: Safe replacements (list files)
+- Phase 2: Review required (list files + concerns)
+- Phase 3: Related updates (imports, tests, docs)
+
+4. **Risk Assessment:**
+- Breaking change likelihood (High/Medium/Low)
+- Rollback strategy
+- Files to backup first
+
+⚠️ **If matches exceed ${maxResults}**: Report total count and recommend narrowing \`filePattern\` or \`searchPattern\`.`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=search-and-replace.js.map

package/dist/prompts/search-and-replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-and-replace.js","sourceRoot":"","sources":["../../src/prompts/search-and-replace.ts"],"names":[],"mappings":"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"}

package/dist/prompts/shared.d.ts

@@ -0,0 +1,3 @@
+export declare function pathCompleter(value: string): string[];
+export declare const DEFAULT_EXCLUDES: readonly ["node_modules/**", ".git/**", "dist/**", "build/**", "coverage/**"];
+//# sourceMappingURL=shared.d.ts.map

package/dist/prompts/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/prompts/shared.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrD;AAGD,eAAO,MAAM,gBAAgB,+EAMnB,CAAC"}

package/dist/prompts/shared.js

@@ -0,0 +1,17 @@
+import { getAllowedDirectories } from '../lib/path-validation.js';
+// Path autocompletion for prompt arguments
+export function pathCompleter(value) {
+    const dirs = getAllowedDirectories();
+    const lowerValue = value.toLowerCase();
+    return dirs.filter((d) => d.toLowerCase().includes(lowerValue) ||
+        lowerValue.includes(d.toLowerCase().slice(0, 10)));
+}
+// Common directories to exclude from filesystem operations
+export const DEFAULT_EXCLUDES = [
+    'node_modules/**',
+    '.git/**',
+    'dist/**',
+    'build/**',
+    'coverage/**',
+];
+//# sourceMappingURL=shared.js.map

package/dist/prompts/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/prompts/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;QACpC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CACpD,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,iBAAiB;IACjB,SAAS;IACT,SAAS;IACT,UAAU;IACV,aAAa;CACL,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAllResources(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwE5D"}