kemdicode-mcp 1.15.0

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

@@ -0,0 +1,88 @@
+/**
+ * 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/>.
+ */
+/**
+ * Delete Lines Tool
+ *
+ * Delete a range of lines from a file.
+ *
+ * @module tools/edit/delete-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 delete (1-based, inclusive)'),
+    endLine: z.number().int().positive().describe('Last line to delete (1-based, inclusive)'),
+    createBackup: z.boolean().default(true).describe('Create .bak backup before editing'),
+});
+export const deleteLinesTool = {
+    name: 'delete-lines',
+    description: 'Delete a range of lines from a file',
+    zodSchema: schema,
+    execute: async (args) => {
+        const { path: inputPath, startLine, endLine, createBackup } = args;
+        // Common validation: rate limit + path
+        const validation = await validateEditRequest('delete-lines', inputPath);
+        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,
+                });
+            }
+            // Extract deleted content for preview
+            const deletedLines = lines.slice(startLine - 1, endLine);
+            const deletedContent = deletedLines.join('\n');
+            const linesDeleted = deletedLines.length;
+            // Delete lines (splice removes from startLine-1, count = endLine - startLine + 1)
+            lines.splice(startLine - 1, linesDeleted);
+            // Write back
+            const backupPath = await writeFileLines(validatedPath, lines, createBackup);
+            Logger.debug(`delete-lines: deleted lines ${startLine}-${endLine} (${linesDeleted} lines) from ${validatedPath}`);
+            return JSON.stringify({
+                success: true,
+                path: validatedPath,
+                startLine,
+                endLine,
+                linesDeleted,
+                deletedContent: truncateForPreview(deletedContent, 500),
+                newTotalLines: lines.length,
+                backup: backupPath,
+            });
+        }
+        catch (error) {
+            return formatEditError('delete-lines', error, validatedPath);
+        }
+    },
+};
+//# sourceMappingURL=delete-lines.tool.js.map

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

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

package/dist/tools/edit/edit-shared.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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/>.
+ */
+/** Maximum content size (10MB) */
+export declare const MAX_CONTENT_SIZE: number;
+/**
+ * Early validation result: either an error response string or a validated path.
+ */
+export type EarlyValidationResult = {
+    ok: true;
+    validatedPath: string;
+} | {
+    ok: false;
+    errorResponse: string;
+};
+/**
+ * Perform common early validation shared by all edit tools:
+ * - Rate limit check
+ * - Optional content size check
+ * - Path validation
+ *
+ * @param toolName - Name of the calling tool (for log messages)
+ * @param inputPath - Raw input path from user
+ * @param options - Additional options
+ * @returns Validated path or error response JSON string
+ */
+export declare function validateEditRequest(toolName: string, inputPath: string, options?: {
+    contentLength?: number;
+    operation?: 'read' | 'write';
+}): Promise<EarlyValidationResult>;
+/**
+ * Format a caught error into a JSON error response string.
+ * Handles both Node.js errno errors and generic errors.
+ *
+ * @param toolName - Name of the calling tool (for log messages)
+ * @param error - The caught error
+ * @param validatedPath - The validated file path
+ * @returns JSON error response string
+ */
+export declare function formatEditError(toolName: string, error: unknown, validatedPath: string): string;
+//# sourceMappingURL=edit-shared.d.ts.map

package/dist/tools/edit/edit-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-shared.d.ts","sourceRoot":"","sources":["../../../src/tools/edit/edit-shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB,GACL,OAAO,CAAC,qBAAqB,CAAC,CAqDhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAoB/F"}

package/dist/tools/edit/edit-shared.js

@@ -0,0 +1,122 @@
+/**
+ * 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/>.
+ */
+/**
+ * Shared Edit Tool Utilities
+ *
+ * Common logic extracted from line-editing tools to reduce duplication.
+ * Handles rate limiting, path validation, content size checks, and error formatting.
+ *
+ * @module tools/edit/edit-shared
+ */
+import { Logger } from '../../utils/logger.js';
+import { fromNodeError, formatErrorResponse } from '../../utils/errors.js';
+import { validatePath, ValidationError, checkRateLimit } from '../../utils/validation.js';
+/** Maximum content size (10MB) */
+export const MAX_CONTENT_SIZE = 10 * 1024 * 1024;
+/**
+ * Perform common early validation shared by all edit tools:
+ * - Rate limit check
+ * - Optional content size check
+ * - Path validation
+ *
+ * @param toolName - Name of the calling tool (for log messages)
+ * @param inputPath - Raw input path from user
+ * @param options - Additional options
+ * @returns Validated path or error response JSON string
+ */
+export async function validateEditRequest(toolName, inputPath, options = {}) {
+    const { contentLength, operation = 'write' } = options;
+    // Rate limit check
+    if (!checkRateLimit('edit-operations', { maxRequests: 50, windowMs: 60000 })) {
+        return {
+            ok: false,
+            errorResponse: JSON.stringify({
+                success: false,
+                error: 'Rate limit exceeded for edit operations',
+                code: 'RATE_LIMIT_EXCEEDED',
+                path: inputPath,
+            }),
+        };
+    }
+    // Content size check (for tools that accept content input)
+    if (contentLength !== undefined && contentLength > MAX_CONTENT_SIZE) {
+        return {
+            ok: false,
+            errorResponse: JSON.stringify({
+                success: false,
+                error: `Content too large: ${contentLength} bytes (max: ${MAX_CONTENT_SIZE} bytes)`,
+                code: 'CONTENT_TOO_LARGE',
+                path: inputPath,
+            }),
+        };
+    }
+    // Path validation
+    try {
+        const validatedPath = await validatePath(inputPath, {
+            allowSymlinks: false,
+            requireWithinProject: false,
+            allowReadFromBlocked: false,
+            operation,
+        });
+        return { ok: true, validatedPath };
+    }
+    catch (validationError) {
+        if (validationError instanceof ValidationError) {
+            Logger.warn(`${toolName} security validation failed: ${validationError.message}`);
+            return {
+                ok: false,
+                errorResponse: JSON.stringify({
+                    success: false,
+                    error: validationError.message,
+                    code: validationError.code,
+                    path: inputPath,
+                }),
+            };
+        }
+        throw validationError;
+    }
+}
+/**
+ * Format a caught error into a JSON error response string.
+ * Handles both Node.js errno errors and generic errors.
+ *
+ * @param toolName - Name of the calling tool (for log messages)
+ * @param error - The caught error
+ * @param validatedPath - The validated file path
+ * @returns JSON error response string
+ */
+export function formatEditError(toolName, error, validatedPath) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    Logger.error(`${toolName} error: ${errorMessage}`);
+    const nodeError = error;
+    if (nodeError.code) {
+        const mcpError = fromNodeError(nodeError, validatedPath, 'write');
+        const errorResponse = formatErrorResponse(mcpError);
+        return JSON.stringify({
+            success: false,
+            path: validatedPath,
+            ...errorResponse,
+        });
+    }
+    return JSON.stringify({
+        success: false,
+        path: validatedPath,
+        error: errorMessage,
+    });
+}
+//# sourceMappingURL=edit-shared.js.map

package/dist/tools/edit/edit-shared.js.map

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

package/dist/tools/edit/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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/>.
+ */
+/**
+ * Edit Tools
+ *
+ * Line-based file editing tools for precise content manipulation.
+ *
+ * @module tools/edit
+ */
+export { insertAtLineTool } from './insert-at-line.tool.js';
+export { deleteLinesTool } from './delete-lines.tool.js';
+export { replaceLinesTool } from './replace-lines.tool.js';
+export { replaceContentTool } from './replace-content.tool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/edit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/edit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/edit/index.js

@@ -0,0 +1,29 @@
+/**
+ * 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/>.
+ */
+/**
+ * Edit Tools
+ *
+ * Line-based file editing tools for precise content manipulation.
+ *
+ * @module tools/edit
+ */
+export { insertAtLineTool } from './insert-at-line.tool.js';
+export { deleteLinesTool } from './delete-lines.tool.js';
+export { replaceLinesTool } from './replace-lines.tool.js';
+export { replaceContentTool } from './replace-content.tool.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/edit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/edit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/edit/insert-at-line.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 insertAtLineTool: UnifiedTool;
+//# sourceMappingURL=insert-at-line.tool.d.ts.map

package/dist/tools/edit/insert-at-line.tool.d.ts.map

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

package/dist/tools/edit/insert-at-line.tool.js

@@ -0,0 +1,92 @@
+/**
+ * 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/>.
+ */
+/**
+ * Insert At Line Tool
+ *
+ * Insert content at a specific line number in a file.
+ * Content is inserted before the specified line.
+ *
+ * @module tools/edit/insert-at-line
+ */
+import { z } from 'zod';
+import { Logger } from '../../utils/logger.js';
+import { readFileLines, writeFileLines, validateLineNumber } 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'),
+    line: z
+        .number()
+        .int()
+        .positive()
+        .describe('Line number to insert at (1-based, content inserted before this line)'),
+    content: z.string().describe('Content to insert (can be multiple lines)'),
+    createBackup: z.boolean().default(true).describe('Create .bak backup before editing'),
+});
+export const insertAtLineTool = {
+    name: 'insert-at-line',
+    description: 'Insert content at a specific line number in a file',
+    zodSchema: schema,
+    execute: async (args) => {
+        const { path: inputPath, line, content, createBackup } = args;
+        // Common validation: rate limit + content size + path
+        const validation = await validateEditRequest('insert-at-line', 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 number (allow inserting at end)
+            try {
+                validateLineNumber(line, totalLines, true);
+            }
+            catch (validationError) {
+                return JSON.stringify({
+                    success: false,
+                    error: validationError.message,
+                    code: 'INVALID_LINE_NUMBER',
+                    path: validatedPath,
+                    totalLines,
+                });
+            }
+            // Split content into lines to insert
+            const linesToInsert = content.split('\n');
+            const linesInserted = linesToInsert.length;
+            // Insert at position (line - 1 for 0-based array index)
+            lines.splice(line - 1, 0, ...linesToInsert);
+            // Write back
+            const backupPath = await writeFileLines(validatedPath, lines, createBackup);
+            Logger.debug(`insert-at-line: inserted ${linesInserted} lines at line ${line} in ${validatedPath}`);
+            return JSON.stringify({
+                success: true,
+                path: validatedPath,
+                line,
+                linesInserted,
+                newTotalLines: lines.length,
+                backup: backupPath,
+            });
+        }
+        catch (error) {
+            return formatEditError('insert-at-line', error, validatedPath);
+        }
+    },
+};
+//# sourceMappingURL=insert-at-line.tool.js.map

package/dist/tools/edit/insert-at-line.tool.js.map

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

package/dist/tools/edit/replace-content.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 replaceContentTool: UnifiedTool;
+//# sourceMappingURL=replace-content.tool.d.ts.map

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

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