kemdicode-mcp 1.15.0

package/dist/tools/edit/replace-content.tool.js

@@ -0,0 +1,214 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Replace Content Tool
+ *
+ * Find and replace text or patterns in a file.
+ * Supports literal strings and regex patterns.
+ *
+ * @module tools/edit/replace-content
+ */
+import { z } from 'zod';
+import { promises as fs } from 'fs';
+import { Logger } from '../../utils/logger.js';
+import { validateRegexPattern, ValidationError, } from '../../utils/validation.js';
+import { validateEditRequest, formatEditError } from './edit-shared.js';
+const schema = z.object({
+    path: z.string().min(1).describe('File path to edit'),
+    search: z.string().min(1).describe('Text or regex pattern to search for'),
+    replace: z.string().describe('Replacement text (supports $1, $2 for regex groups)'),
+    isRegex: z.boolean().default(false).describe('Treat search as regex pattern'),
+    replaceAll: z.boolean().default(true).describe('Replace all occurrences (false = first only)'),
+    caseSensitive: z.boolean().default(true).describe('Case-sensitive matching'),
+    createBackup: z.boolean().default(true).describe('Create .bak backup before editing'),
+    dryRun: z.boolean().default(false).describe('Preview changes without applying'),
+});
+/** Maximum file size to process (10MB) */
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+/**
+ * Create backup of a file
+ */
+async function createBackupFile(filePath) {
+    try {
+        const stats = await fs.stat(filePath);
+        if (stats.isFile()) {
+            const backupPath = `${filePath}.bak`;
+            await fs.copyFile(filePath, backupPath);
+            return backupPath;
+        }
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    return null;
+}
+/**
+ * Find match locations and create previews
+ */
+function findMatchPreviews(content, regex, replacement, maxPreviews = 5) {
+    const previews = [];
+    const lines = content.split('\n');
+    let lineIndex = 0;
+    let charIndex = 0;
+    // Create a copy of regex for global search
+    const searchRegex = new RegExp(regex.source, regex.flags.includes('g') ? regex.flags : regex.flags + 'g');
+    let match;
+    while ((match = searchRegex.exec(content)) !== null && previews.length < maxPreviews) {
+        // Find which line this match is on
+        while (lineIndex < lines.length && charIndex + lines[lineIndex].length < match.index) {
+            charIndex += lines[lineIndex].length + 1; // +1 for newline
+            lineIndex++;
+        }
+        const originalLine = lines[lineIndex];
+        const matchedLine = originalLine.replace(regex, replacement);
+        previews.push({
+            line: lineIndex + 1,
+            before: truncateLine(originalLine),
+            after: truncateLine(matchedLine),
+        });
+        // Prevent infinite loop on zero-width matches
+        if (match[0].length === 0) {
+            searchRegex.lastIndex++;
+        }
+    }
+    return previews;
+}
+/**
+ * Truncate a line for preview
+ */
+function truncateLine(line, maxLength = 100) {
+    if (line.length <= maxLength) {
+        return line;
+    }
+    return line.slice(0, maxLength - 3) + '...';
+}
+export const replaceContentTool = {
+    name: 'replace-content',
+    description: 'Find and replace text or patterns in a file (supports regex)',
+    zodSchema: schema,
+    execute: async (args) => {
+        const { path: inputPath, search, replace, isRegex, replaceAll, caseSensitive, createBackup, dryRun, } = args;
+        // Validate regex if using regex mode
+        if (isRegex) {
+            try {
+                validateRegexPattern(search);
+            }
+            catch (regexError) {
+                if (regexError instanceof ValidationError) {
+                    return JSON.stringify({
+                        success: false,
+                        error: `Invalid regex pattern: ${regexError.message}`,
+                        code: regexError.code,
+                        path: inputPath,
+                    });
+                }
+                throw regexError;
+            }
+        }
+        // Common validation: rate limit + path
+        const validation = await validateEditRequest('replace-content', inputPath, {
+            operation: dryRun ? 'read' : 'write',
+        });
+        if (!validation.ok)
+            return validation.errorResponse;
+        const { validatedPath } = validation;
+        try {
+            // Check file size
+            const stats = await fs.stat(validatedPath);
+            if (stats.size > MAX_FILE_SIZE) {
+                return JSON.stringify({
+                    success: false,
+                    error: `File too large: ${stats.size} bytes (max: ${MAX_FILE_SIZE} bytes)`,
+                    code: 'FILE_TOO_LARGE',
+                    path: validatedPath,
+                });
+            }
+            // Read file content
+            const content = await fs.readFile(validatedPath, 'utf8');
+            // Build regex
+            let flags = '';
+            if (replaceAll)
+                flags += 'g';
+            if (!caseSensitive)
+                flags += 'i';
+            let regex;
+            if (isRegex) {
+                regex = new RegExp(search, flags);
+            }
+            else {
+                // Escape special regex characters for literal search
+                const escaped = search.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                regex = new RegExp(escaped, flags);
+            }
+            // Count matches
+            const matches = content.match(new RegExp(regex.source, regex.flags.includes('g') ? regex.flags : regex.flags + 'g'));
+            const matchCount = matches ? matches.length : 0;
+            if (matchCount === 0) {
+                return JSON.stringify({
+                    success: true,
+                    path: validatedPath,
+                    matchCount: 0,
+                    replacedCount: 0,
+                    message: 'No matches found',
+                    dryRun,
+                });
+            }
+            // Calculate how many will be replaced
+            const replacedCount = replaceAll ? matchCount : Math.min(1, matchCount);
+            // Generate preview
+            const preview = findMatchPreviews(content, regex, replace);
+            if (dryRun) {
+                Logger.debug(`replace-content (dry-run): would replace ${replacedCount} of ${matchCount} matches in ${validatedPath}`);
+                return JSON.stringify({
+                    success: true,
+                    path: validatedPath,
+                    matchCount,
+                    replacedCount,
+                    preview,
+                    dryRun: true,
+                });
+            }
+            // Apply replacement
+            const newContent = content.replace(regex, replace);
+            // Create backup if requested
+            let backupPath = null;
+            if (createBackup) {
+                backupPath = await createBackupFile(validatedPath);
+            }
+            // Write new content
+            await fs.writeFile(validatedPath, newContent, 'utf8');
+            Logger.debug(`replace-content: replaced ${replacedCount} occurrences in ${validatedPath}`);
+            return JSON.stringify({
+                success: true,
+                path: validatedPath,
+                matchCount,
+                replacedCount,
+                preview,
+                backup: backupPath,
+                dryRun: false,
+            });
+        }
+        catch (error) {
+            return formatEditError('replace-content', error, validatedPath);
+        }
+    },
+};
+//# sourceMappingURL=replace-content.tool.js.map

package/dist/tools/edit/replace-content.tool.js.map

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

package/dist/tools/edit/replace-lines.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { UnifiedTool } from '../registry.js';
+export declare const replaceLinesTool: UnifiedTool;
+//# sourceMappingURL=replace-lines.tool.d.ts.map

package/dist/tools/edit/replace-lines.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-lines.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/edit/replace-lines.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAoB7C,eAAO,MAAM,gBAAgB,EAAE,WAoE9B,CAAC"}

package/dist/tools/edit/replace-lines.tool.js

@@ -0,0 +1,97 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Replace Lines Tool
+ *
+ * Replace a range of lines with new content.
+ * The new content can have more or fewer lines than the replaced range.
+ *
+ * @module tools/edit/replace-lines
+ */
+import { z } from 'zod';
+import { Logger } from '../../utils/logger.js';
+import { readFileLines, writeFileLines, validateLineRange, truncateForPreview, } from '../../utils/edit-utils.js';
+import { validateEditRequest, formatEditError } from './edit-shared.js';
+const schema = z.object({
+    path: z.string().min(1).describe('File path to edit'),
+    startLine: z.number().int().positive().describe('First line to replace (1-based, inclusive)'),
+    endLine: z.number().int().positive().describe('Last line to replace (1-based, inclusive)'),
+    content: z.string().describe('New content to insert (can be more or fewer lines)'),
+    createBackup: z.boolean().default(true).describe('Create .bak backup before editing'),
+});
+export const replaceLinesTool = {
+    name: 'replace-lines',
+    description: 'Replace a range of lines with new content',
+    zodSchema: schema,
+    execute: async (args) => {
+        const { path: inputPath, startLine, endLine, content, createBackup } = args;
+        // Common validation: rate limit + content size + path
+        const validation = await validateEditRequest('replace-lines', inputPath, {
+            contentLength: content.length,
+        });
+        if (!validation.ok)
+            return validation.errorResponse;
+        const { validatedPath } = validation;
+        try {
+            // Read existing file
+            const lines = await readFileLines(validatedPath);
+            const totalLines = lines.length;
+            // Validate line range
+            try {
+                validateLineRange(startLine, endLine, totalLines);
+            }
+            catch (validationError) {
+                return JSON.stringify({
+                    success: false,
+                    error: validationError.message,
+                    code: 'INVALID_LINE_RANGE',
+                    path: validatedPath,
+                    totalLines,
+                });
+            }
+            // Calculate stats
+            const originalLinesCount = endLine - startLine + 1;
+            const newLines = content.split('\n');
+            const newLinesCount = newLines.length;
+            const lineDelta = newLinesCount - originalLinesCount;
+            // Get preview of replaced content
+            const replacedContent = lines.slice(startLine - 1, endLine).join('\n');
+            // Replace lines
+            lines.splice(startLine - 1, originalLinesCount, ...newLines);
+            // Write back
+            const backupPath = await writeFileLines(validatedPath, lines, createBackup);
+            Logger.debug(`replace-lines: replaced lines ${startLine}-${endLine} (${originalLinesCount} -> ${newLinesCount} lines) in ${validatedPath}`);
+            return JSON.stringify({
+                success: true,
+                path: validatedPath,
+                startLine,
+                endLine,
+                originalLines: originalLinesCount,
+                newLines: newLinesCount,
+                lineDelta,
+                replacedContent: truncateForPreview(replacedContent, 300),
+                newTotalLines: lines.length,
+                backup: backupPath,
+            });
+        }
+        catch (error) {
+            return formatEditError('replace-lines', error, validatedPath);
+        }
+    },
+};
+//# sourceMappingURL=replace-lines.tool.js.map

package/dist/tools/edit/replace-lines.tool.js.map

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

package/dist/tools/file/file-diff.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { UnifiedTool } from '../registry.js';
+export declare const fileDiffTool: UnifiedTool;
+//# sourceMappingURL=file-diff.tool.d.ts.map

package/dist/tools/file/file-diff.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-diff.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/file/file-diff.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA8T7C,eAAO,MAAM,YAAY,EAAE,WAsF1B,CAAC"}