kemdicode-mcp 1.15.0

package/dist/tools/code/insert-after-symbol.tool.js

@@ -0,0 +1,224 @@
+/**
+ * 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 After Symbol Tool
+ *
+ * Inserts content after a symbol's definition block in the codebase.
+ * Detects the end of the symbol block (closing brace or dedent).
+ *
+ * @module tools/code/insert-after-symbol
+ */
+import { z } from 'zod';
+import { Logger } from '../../utils/logger.js';
+import { validatePath, ValidationError, checkRateLimit } from '../../utils/validation.js';
+import { readFileLines, writeFileLines } from '../../utils/edit-utils.js';
+import { parseFile, findSymbolBlockEnd as treeSitterFindBlockEnd, getLanguageFromFile, } from '../../tree-sitter/index.js';
+import { findSymbolDefinition, findSymbolAuto, } from './symbol-search.js';
+/** Languages that use braces for blocks */
+const BRACE_LANGUAGES = ['ts', 'php', 'go', 'rs'];
+/** Languages that use indentation for blocks */
+const INDENT_LANGUAGES = ['py'];
+const schema = z.object({
+    symbol: z.string().min(1).describe('Symbol name to find'),
+    content: z.string().describe('Content to insert after the symbol block'),
+    path: z.string().optional().describe('File or directory to search in'),
+    language: z
+        .enum(['ts', 'php', 'py', 'go', 'rs', 'auto'])
+        .default('auto')
+        .describe('Target language'),
+    createBackup: z.boolean().default(true).describe('Create backup before editing'),
+});
+/**
+ * Find the end of a brace-delimited block
+ */
+function findBraceBlockEnd(lines, startLine) {
+    let braceCount = 0;
+    let foundOpenBrace = false;
+    for (let i = startLine; i < lines.length; i++) {
+        const line = lines[i];
+        for (const char of line) {
+            if (char === '{') {
+                braceCount++;
+                foundOpenBrace = true;
+            }
+            else if (char === '}') {
+                braceCount--;
+                if (foundOpenBrace && braceCount === 0) {
+                    return i;
+                }
+            }
+        }
+    }
+    // If no braces found, it might be a single-line definition
+    return startLine;
+}
+/**
+ * Find the end of an indentation-based block (Python)
+ */
+function findIndentBlockEnd(lines, startLine) {
+    if (startLine >= lines.length)
+        return startLine;
+    // Get the indentation of the definition line
+    const defLine = lines[startLine];
+    const defIndent = defLine.match(/^(\s*)/)?.[1].length || 0;
+    // Find lines that are part of the block (more indented or empty)
+    for (let i = startLine + 1; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip empty lines
+        if (line.trim() === '')
+            continue;
+        const lineIndent = line.match(/^(\s*)/)?.[1].length || 0;
+        // If we find a line with same or less indentation, block ended at previous line
+        if (lineIndent <= defIndent) {
+            return i - 1;
+        }
+    }
+    // Block extends to end of file
+    return lines.length - 1;
+}
+/**
+ * Find the end of a symbol's block (regex-based fallback)
+ */
+function findSymbolBlockEndRegex(lines, startLine, language) {
+    // Convert to 0-based index
+    const lineIndex = startLine - 1;
+    if (BRACE_LANGUAGES.includes(language)) {
+        return findBraceBlockEnd(lines, lineIndex);
+    }
+    else if (INDENT_LANGUAGES.includes(language)) {
+        return findIndentBlockEnd(lines, lineIndex);
+    }
+    // Default: assume single line
+    return lineIndex;
+}
+/**
+ * Find the end of a symbol's block using tree-sitter (with fallback to regex)
+ */
+async function findSymbolBlockEnd(filePath, symbolName, startLine, lines, language) {
+    // Try tree-sitter first for supported languages
+    const tsLanguage = getLanguageFromFile(filePath);
+    if (tsLanguage) {
+        try {
+            const { tree } = await parseFile(filePath);
+            const blockEnd = treeSitterFindBlockEnd(tree, tsLanguage, symbolName);
+            if (blockEnd !== null) {
+                Logger.debug(`insert-after-symbol: tree-sitter found block end at line ${blockEnd + 1}`);
+                return blockEnd; // tree-sitter returns 0-indexed
+            }
+        }
+        catch (error) {
+            Logger.debug(`insert-after-symbol: tree-sitter failed, using regex fallback: ${error}`);
+        }
+    }
+    // Fallback to regex-based detection
+    return findSymbolBlockEndRegex(lines, startLine, language);
+}
+export const insertAfterSymbolTool = {
+    name: 'insert-after-symbol',
+    description: 'Insert content after a symbol definition block (after closing brace/dedent)',
+    zodSchema: schema,
+    execute: async (args) => {
+        const { symbol, content, path: inputPath, language, createBackup, } = args;
+        // Rate limit check
+        if (!checkRateLimit('edit-operations', { maxRequests: 50, windowMs: 60000 })) {
+            return JSON.stringify({
+                success: false,
+                error: 'Rate limit exceeded for edit operations',
+                code: 'RATE_LIMIT_EXCEEDED',
+            });
+        }
+        const searchPath = inputPath || process.cwd();
+        try {
+            // Find the symbol
+            let location = null;
+            let detectedLanguage = language;
+            if (language === 'auto') {
+                const result = await findSymbolAuto(symbol, searchPath);
+                if (result) {
+                    location = result.location;
+                    detectedLanguage = result.language;
+                }
+            }
+            else {
+                location = await findSymbolDefinition(symbol, language, searchPath);
+            }
+            if (!location) {
+                return JSON.stringify({
+                    success: false,
+                    error: `Symbol '${symbol}' not found`,
+                    code: 'SYMBOL_NOT_FOUND',
+                    searchPath,
+                    language: detectedLanguage,
+                });
+            }
+            // Validate the file path for writing
+            let validatedPath;
+            try {
+                validatedPath = await validatePath(location.file, {
+                    allowSymlinks: false,
+                    requireWithinProject: false,
+                    operation: 'write',
+                });
+            }
+            catch (validationError) {
+                if (validationError instanceof ValidationError) {
+                    return JSON.stringify({
+                        success: false,
+                        error: validationError.message,
+                        code: validationError.code,
+                        file: location.file,
+                    });
+                }
+                throw validationError;
+            }
+            // Read file
+            const lines = await readFileLines(validatedPath);
+            // Find end of symbol block using tree-sitter (with regex fallback)
+            const effectiveLanguage = detectedLanguage === 'auto' ? 'ts' : detectedLanguage;
+            const blockEndLine = await findSymbolBlockEnd(validatedPath, symbol, location.line, lines, effectiveLanguage);
+            const insertLine = blockEndLine + 1; // Insert after the block
+            // Split content into lines and insert
+            const contentLines = content.split('\n');
+            lines.splice(insertLine, 0, ...contentLines);
+            // Write back
+            const backupPath = await writeFileLines(validatedPath, lines, createBackup);
+            Logger.debug(`insert-after-symbol: inserted ${contentLines.length} lines after '${symbol}' block at ${validatedPath}:${insertLine + 1}`);
+            return JSON.stringify({
+                success: true,
+                file: validatedPath,
+                symbol,
+                symbolStartLine: location.line,
+                symbolEndLine: blockEndLine + 1,
+                insertedAt: insertLine + 1,
+                linesInserted: contentLines.length,
+                newTotalLines: lines.length,
+                backup: backupPath,
+                language: detectedLanguage,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`insert-after-symbol error: ${errorMessage}`);
+            return JSON.stringify({
+                success: false,
+                error: errorMessage,
+            });
+        }
+    },
+};
+//# sourceMappingURL=insert-after-symbol.tool.js.map

package/dist/tools/code/insert-after-symbol.tool.js.map

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

package/dist/tools/code/insert-before-symbol.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 insertBeforeSymbolTool: UnifiedTool;
+//# sourceMappingURL=insert-before-symbol.tool.d.ts.map

package/dist/tools/code/insert-before-symbol.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-before-symbol.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/code/insert-before-symbol.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAuB7C,eAAO,MAAM,sBAAsB,EAAE,WAiHpC,CAAC"}

package/dist/tools/code/insert-before-symbol.tool.js

@@ -0,0 +1,136 @@
+/**
+ * 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 Before Symbol Tool
+ *
+ * Inserts content before a symbol's definition in the codebase.
+ * Uses ripgrep patterns to locate symbols and then inserts content.
+ *
+ * @module tools/code/insert-before-symbol
+ */
+import { z } from 'zod';
+import { Logger } from '../../utils/logger.js';
+import { validatePath, ValidationError, checkRateLimit } from '../../utils/validation.js';
+import { readFileLines, writeFileLines } from '../../utils/edit-utils.js';
+import { findSymbolDefinition, findSymbolAuto, } from './symbol-search.js';
+const schema = z.object({
+    symbol: z.string().min(1).describe('Symbol name to find'),
+    content: z.string().describe('Content to insert before the symbol'),
+    path: z.string().optional().describe('File or directory to search in'),
+    language: z
+        .enum(['ts', 'php', 'py', 'go', 'rs', 'auto'])
+        .default('auto')
+        .describe('Target language'),
+    createBackup: z.boolean().default(true).describe('Create backup before editing'),
+});
+export const insertBeforeSymbolTool = {
+    name: 'insert-before-symbol',
+    description: 'Insert content before a symbol definition (class, function, etc.)',
+    zodSchema: schema,
+    execute: async (args) => {
+        const { symbol, content, path: inputPath, language, createBackup, } = args;
+        // Rate limit check
+        if (!checkRateLimit('edit-operations', { maxRequests: 50, windowMs: 60000 })) {
+            return JSON.stringify({
+                success: false,
+                error: 'Rate limit exceeded for edit operations',
+                code: 'RATE_LIMIT_EXCEEDED',
+            });
+        }
+        const searchPath = inputPath || process.cwd();
+        try {
+            // Find the symbol
+            let location = null;
+            let detectedLanguage = language;
+            if (language === 'auto') {
+                const result = await findSymbolAuto(symbol, searchPath);
+                if (result) {
+                    location = result.location;
+                    detectedLanguage = result.language;
+                }
+            }
+            else {
+                location = await findSymbolDefinition(symbol, language, searchPath);
+            }
+            if (!location) {
+                return JSON.stringify({
+                    success: false,
+                    error: `Symbol '${symbol}' not found`,
+                    code: 'SYMBOL_NOT_FOUND',
+                    searchPath,
+                    language: detectedLanguage,
+                });
+            }
+            // Validate the file path for writing
+            let validatedPath;
+            try {
+                validatedPath = await validatePath(location.file, {
+                    allowSymlinks: false,
+                    requireWithinProject: false,
+                    operation: 'write',
+                });
+            }
+            catch (validationError) {
+                if (validationError instanceof ValidationError) {
+                    return JSON.stringify({
+                        success: false,
+                        error: validationError.message,
+                        code: validationError.code,
+                        file: location.file,
+                    });
+                }
+                throw validationError;
+            }
+            // Read file and insert content
+            const lines = await readFileLines(validatedPath);
+            const insertLine = location.line - 1; // Convert to 0-based index
+            if (insertLine < 0 || insertLine > lines.length) {
+                return JSON.stringify({
+                    success: false,
+                    error: `Invalid line number: ${location.line}`,
+                    code: 'INVALID_LINE',
+                });
+            }
+            // Split content into lines and insert
+            const contentLines = content.split('\n');
+            lines.splice(insertLine, 0, ...contentLines);
+            // Write back
+            const backupPath = await writeFileLines(validatedPath, lines, createBackup);
+            Logger.debug(`insert-before-symbol: inserted ${contentLines.length} lines before '${symbol}' at ${validatedPath}:${location.line}`);
+            return JSON.stringify({
+                success: true,
+                file: validatedPath,
+                symbol,
+                insertedAt: location.line,
+                linesInserted: contentLines.length,
+                newTotalLines: lines.length,
+                backup: backupPath,
+                language: detectedLanguage,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`insert-before-symbol error: ${errorMessage}`);
+            return JSON.stringify({
+                success: false,
+                error: errorMessage,
+            });
+        }
+    },
+};
+//# sourceMappingURL=insert-before-symbol.tool.js.map

package/dist/tools/code/insert-before-symbol.tool.js.map

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

package/dist/tools/code/rename-symbol.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 renameSymbolTool: UnifiedTool;
+//# sourceMappingURL=rename-symbol.tool.d.ts.map

package/dist/tools/code/rename-symbol.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-symbol.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/code/rename-symbol.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA+I7C,eAAO,MAAM,gBAAgB,EAAE,WAiJ9B,CAAC"}