kemdicode-mcp 1.15.0

package/dist/tools/file/file-diff.tool.js

@@ -0,0 +1,359 @@
+/**
+ * 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/>.
+ */
+/**
+ * File Diff Tool
+ *
+ * Compare two files and output differences in git diff or unified format.
+ *
+ * @module tools/file/file-diff
+ */
+import { z } from 'zod';
+import { promises as fs } from 'fs';
+import { spawn } from 'child_process';
+import { Logger } from '../../utils/logger.js';
+import { validatePath, ValidationError } from '../../utils/validation.js';
+/** Default timeout for diff (30 seconds) */
+const DIFF_TIMEOUT = 30_000;
+/** Maximum file size to diff (10MB) */
+const MAX_DIFF_SIZE = 10 * 1024 * 1024;
+const schema = z.object({
+    file1: z.string().min(1).describe('First file path (original)'),
+    file2: z.string().min(1).describe('Second file path (modified)'),
+    format: z
+        .enum(['unified', 'git', 'side-by-side', 'context'])
+        .default('unified')
+        .describe('Output format'),
+    contextLines: z.number().int().min(0).max(20).default(3).describe('Number of context lines'),
+    ignoreWhitespace: z.boolean().default(false).describe('Ignore whitespace changes'),
+    ignoreCase: z.boolean().default(false).describe('Case-insensitive comparison'),
+    ignoreBlankLines: z.boolean().default(false).describe('Ignore blank line differences'),
+    showLineNumbers: z.boolean().default(true).describe('Show line numbers'),
+    colorize: z.boolean().default(false).describe('Include ANSI color codes'),
+});
+/**
+ * Check if a file exists and is readable
+ */
+async function validateFile(path) {
+    try {
+        const stats = await fs.stat(path);
+        if (!stats.isFile()) {
+            return { valid: false, error: `Not a file: ${path}` };
+        }
+        if (stats.size > MAX_DIFF_SIZE) {
+            return { valid: false, error: `File too large: ${stats.size} bytes (max: ${MAX_DIFF_SIZE})` };
+        }
+        return { valid: true, size: stats.size };
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === 'ENOENT') {
+            return { valid: false, error: `File not found: ${path}` };
+        }
+        if (nodeError.code === 'EACCES') {
+            return { valid: false, error: `Permission denied: ${path}` };
+        }
+        return { valid: false, error: error.message };
+    }
+}
+/**
+ * Build diff command arguments
+ */
+function buildDiffArgs(args) {
+    const diffArgs = [];
+    switch (args.format) {
+        case 'git':
+            diffArgs.push('--git');
+            break;
+        case 'side-by-side':
+            diffArgs.push('--side-by-side', '--width=160');
+            break;
+        case 'context':
+            diffArgs.push('-c');
+            break;
+        case 'unified':
+        default:
+            diffArgs.push('-u');
+            break;
+    }
+    // Context lines
+    if (args.format === 'unified' || args.format === 'git') {
+        diffArgs.push(`-U${args.contextLines}`);
+    }
+    else if (args.format === 'context') {
+        diffArgs.push(`-C${args.contextLines}`);
+    }
+    if (args.ignoreWhitespace) {
+        diffArgs.push('-w');
+    }
+    if (args.ignoreCase) {
+        diffArgs.push('-i');
+    }
+    if (args.ignoreBlankLines) {
+        diffArgs.push('-B');
+    }
+    if (args.showLineNumbers && args.format !== 'side-by-side') {
+        diffArgs.push('-n');
+    }
+    if (args.colorize) {
+        diffArgs.push('--color=always');
+    }
+    diffArgs.push(args.file1, args.file2);
+    return diffArgs;
+}
+/**
+ * Parse unified diff output into structured hunks
+ */
+function parseUnifiedDiff(diffOutput) {
+    const hunks = [];
+    const lines = diffOutput.split('\n');
+    let currentHunk = null;
+    let oldLine = 0;
+    let newLine = 0;
+    for (const line of lines) {
+        // Skip header lines
+        if (line.startsWith('---') || line.startsWith('+++') || line.startsWith('diff')) {
+            continue;
+        }
+        // Parse hunk header: @@ -start,count +start,count @@
+        const hunkMatch = line.match(/^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/);
+        if (hunkMatch) {
+            if (currentHunk) {
+                hunks.push(currentHunk);
+            }
+            oldLine = parseInt(hunkMatch[1], 10);
+            newLine = parseInt(hunkMatch[3], 10);
+            currentHunk = {
+                oldStart: oldLine,
+                oldCount: parseInt(hunkMatch[2] || '1', 10),
+                newStart: newLine,
+                newCount: parseInt(hunkMatch[4] || '1', 10),
+                lines: [],
+            };
+            continue;
+        }
+        if (!currentHunk)
+            continue;
+        if (line.startsWith('-')) {
+            currentHunk.lines.push({
+                type: 'deletion',
+                content: line.slice(1),
+                oldLine: oldLine++,
+            });
+        }
+        else if (line.startsWith('+')) {
+            currentHunk.lines.push({
+                type: 'addition',
+                content: line.slice(1),
+                newLine: newLine++,
+            });
+        }
+        else if (line.startsWith(' ') || line === '') {
+            currentHunk.lines.push({
+                type: 'context',
+                content: line.slice(1) || '',
+                oldLine: oldLine++,
+                newLine: newLine++,
+            });
+        }
+    }
+    if (currentHunk) {
+        hunks.push(currentHunk);
+    }
+    return hunks;
+}
+/**
+ * Calculate diff statistics
+ */
+function calculateStats(hunks) {
+    let additions = 0;
+    let deletions = 0;
+    for (const hunk of hunks) {
+        for (const line of hunk.lines) {
+            if (line.type === 'addition')
+                additions++;
+            if (line.type === 'deletion')
+                deletions++;
+        }
+    }
+    return {
+        additions,
+        deletions,
+        changes: additions + deletions,
+    };
+}
+/**
+ * Execute diff using git diff or system diff
+ */
+async function executeDiff(args) {
+    return new Promise((resolve, reject) => {
+        // Try git diff first (better output), fall back to diff
+        const diffArgs = buildDiffArgs(args);
+        // Use git diff --no-index for non-git files
+        const useGit = args.format === 'git';
+        const command = useGit ? 'git' : 'diff';
+        const commandArgs = useGit ? ['diff', '--no-index', ...diffArgs.slice(1)] : diffArgs;
+        const proc = spawn(command, commandArgs, {
+            shell: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: DIFF_TIMEOUT,
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('error', (error) => {
+            proc.kill(); // Zamknij oryginalny proces
+            // If git fails, try regular diff
+            if (useGit && error.code === 'ENOENT') {
+                const fallbackArgs = buildDiffArgs({ ...args, format: 'unified' });
+                const fallbackProc = spawn('diff', fallbackArgs, {
+                    shell: false,
+                    stdio: ['ignore', 'pipe', 'pipe'],
+                    timeout: DIFF_TIMEOUT,
+                });
+                let fallbackStdout = '';
+                let fallbackStderr = '';
+                fallbackProc.stdout.on('data', (data) => {
+                    fallbackStdout += data.toString();
+                });
+                fallbackProc.stderr.on('data', (data) => {
+                    fallbackStderr += data.toString();
+                });
+                fallbackProc.on('close', (code) => {
+                    // diff exit codes: 0 = identical, 1 = different, 2 = error
+                    if (code === 0) {
+                        resolve({ stdout: '', identical: true });
+                    }
+                    else if (code === 1) {
+                        resolve({ stdout: fallbackStdout, identical: false });
+                    }
+                    else {
+                        reject(new Error(`diff failed with exit code ${code}: ${fallbackStderr.trim()}`));
+                    }
+                });
+                fallbackProc.on('error', (fallbackError) => {
+                    reject(new Error(`diff not available: ${fallbackError.message}`));
+                });
+                return;
+            }
+            reject(error);
+        });
+        proc.on('close', (code) => {
+            // git diff exit codes: 0 = identical, 1 = different, other = error
+            if (code === 0) {
+                resolve({ stdout: '', identical: true });
+            }
+            else if (code === 1) {
+                resolve({ stdout, identical: false });
+            }
+            else {
+                // Check stderr for actual errors
+                if (stderr.includes('fatal:') || stderr.includes('error:')) {
+                    reject(new Error(stderr.trim()));
+                }
+                else {
+                    resolve({ stdout, identical: false });
+                }
+            }
+        });
+    });
+}
+export const fileDiffTool = {
+    name: 'file-diff',
+    description: 'Compare two files with git diff or unified format output',
+    zodSchema: schema,
+    execute: async (args) => {
+        const diffArgs = args;
+        const result = {
+            success: false,
+            file1: diffArgs.file1,
+            file2: diffArgs.file2,
+        };
+        try {
+            // Validate both paths for security (path traversal protection)
+            let validatedPath1;
+            let validatedPath2;
+            try {
+                validatedPath1 = await validatePath(diffArgs.file1, {
+                    allowSymlinks: false,
+                    requireWithinProject: true,
+                    allowReadFromBlocked: false,
+                    operation: 'read',
+                });
+                validatedPath2 = await validatePath(diffArgs.file2, {
+                    allowSymlinks: false,
+                    requireWithinProject: true,
+                    allowReadFromBlocked: false,
+                    operation: 'read',
+                });
+            }
+            catch (validationError) {
+                if (validationError instanceof ValidationError) {
+                    result.error = `Path validation failed: ${validationError.message}`;
+                }
+                else {
+                    result.error = `Path validation failed: ${validationError.message}`;
+                }
+                return JSON.stringify(result);
+            }
+            // Validate both files (existence, size)
+            const [validation1, validation2] = await Promise.all([
+                validateFile(validatedPath1),
+                validateFile(validatedPath2),
+            ]);
+            if (!validation1.valid) {
+                result.error = validation1.error;
+                return JSON.stringify(result);
+            }
+            if (!validation2.valid) {
+                result.error = validation2.error;
+                return JSON.stringify(result);
+            }
+            // Execute diff with validated paths
+            const { stdout, identical } = await executeDiff({
+                ...diffArgs,
+                file1: validatedPath1,
+                file2: validatedPath2,
+            });
+            result.success = true;
+            result.identical = identical;
+            if (identical) {
+                result.stats = { additions: 0, deletions: 0, changes: 0 };
+                return JSON.stringify(result);
+            }
+            result.rawDiff = stdout;
+            // Parse hunks for structured output
+            if (diffArgs.format === 'unified' || diffArgs.format === 'git') {
+                result.hunks = parseUnifiedDiff(stdout);
+                result.stats = calculateStats(result.hunks);
+            }
+            return JSON.stringify(result);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`file-diff error: ${errorMessage}`);
+            result.error = errorMessage;
+            return JSON.stringify(result);
+        }
+    },
+};
+//# sourceMappingURL=file-diff.tool.js.map

package/dist/tools/file/file-diff.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-diff.tool.js","sourceRoot":"","sources":["../../../src/tools/file/file-diff.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE1E,4CAA4C;AAC5C,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B,uCAAuC;AACvC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAChE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;SACnD,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,eAAe,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC5F,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAClF,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC9E,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACtF,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACxE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC1E,CAAC,CAAC;AAgCH;;GAEG;AACH,KAAK,UAAU,YAAY,CACzB,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,IAAI,EAAE,EAAE,CAAC;QACxD,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,KAAK,CAAC,IAAI,gBAAgB,aAAa,GAAG,EAAE,CAAC;QAChG,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,KAA8B,CAAC;QACjD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,IAAI,EAAE,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAkB;IACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,KAAK;YACR,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,MAAM;QACR,KAAK,cAAc;YACjB,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;YAC/C,MAAM;QACR,KAAK,SAAS;YACZ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,MAAM;QACR,KAAK,SAAS,CAAC;QACf;YACE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,MAAM;IACV,CAAC;IAED,gBAAgB;IAChB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,WAAW,GAAoB,IAAI,CAAC;IACxC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,oBAAoB;QACpB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChF,SAAS;QACX,CAAC;QAED,qDAAqD;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC5E,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,WAAW,GAAG;gBACZ,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;gBAC3C,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;gBAC3C,KAAK,EAAE,EAAE;aACV,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,CAAC,WAAW;YAAE,SAAS;QAE3B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtB,OAAO,EAAE,OAAO,EAAE;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtB,OAAO,EAAE,OAAO,EAAE;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAC/C,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC5B,OAAO,EAAE,OAAO,EAAE;gBAClB,OAAO,EAAE,OAAO,EAAE;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,KAAiB;IAKvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,SAAS,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,SAAS,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS;QACT,SAAS;QACT,OAAO,EAAE,SAAS,GAAG,SAAS;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,IAAkB;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,wDAAwD;QACxD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAErC,4CAA4C;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACxC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAErF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE;YACvC,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,4BAA4B;YAEzC,iCAAiC;YACjC,IAAI,MAAM,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjE,MAAM,YAAY,GAAG,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBACnE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE;oBAC/C,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;oBACjC,OAAO,EAAE,YAAY;iBACtB,CAAC,CAAC;gBAEH,IAAI,cAAc,GAAG,EAAE,CAAC;gBACxB,IAAI,cAAc,GAAG,EAAE,CAAC;gBAExB,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBACtC,cAAc,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpC,CAAC,CAAC,CAAC;gBAEH,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBACtC,cAAc,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpC,CAAC,CAAC,CAAC;gBAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;oBAChC,2DAA2D;oBAC3D,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;wBACf,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC3C,CAAC;yBAAM,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;wBACtB,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;oBACxD,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,IAAI,KAAK,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;oBACpF,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,EAAE;oBACzC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACpE,CAAC,CAAC,CAAC;gBAEH,OAAO;YACT,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,mEAAmE;YACnE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,iCAAiC;gBACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC3D,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,0DAA0D;IACvE,SAAS,EAAE,MAAM;IAEjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAmB,EAAE;QACvC,MAAM,QAAQ,GAAG,IAAoB,CAAC;QACtC,MAAM,MAAM,GAAe;YACzB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;QAEF,IAAI,CAAC;YACH,+DAA+D;YAC/D,IAAI,cAAsB,CAAC;YAC3B,IAAI,cAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,cAAc,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAClD,aAAa,EAAE,KAAK;oBACpB,oBAAoB,EAAE,IAAI;oBAC1B,oBAAoB,EAAE,KAAK;oBAC3B,SAAS,EAAE,MAAM;iBAClB,CAAC,CAAC;gBACH,cAAc,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAClD,aAAa,EAAE,KAAK;oBACpB,oBAAoB,EAAE,IAAI;oBAC1B,oBAAoB,EAAE,KAAK;oBAC3B,SAAS,EAAE,MAAM;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,eAAe,EAAE,CAAC;gBACzB,IAAI,eAAe,YAAY,eAAe,EAAE,CAAC;oBAC/C,MAAM,CAAC,KAAK,GAAG,2BAA2B,eAAe,CAAC,OAAO,EAAE,CAAC;gBACtE,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,KAAK,GAAG,2BAA4B,eAAyB,CAAC,OAAO,EAAE,CAAC;gBACjF,CAAC;gBACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,wCAAwC;YACxC,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACnD,YAAY,CAAC,cAAc,CAAC;gBAC5B,YAAY,CAAC,cAAc,CAAC;aAC7B,CAAC,CAAC;YAEH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;gBACjC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;gBACjC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,oCAAoC;YACpC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,WAAW,CAAC;gBAC9C,GAAG,QAAQ;gBACX,KAAK,EAAE,cAAc;gBACrB,KAAK,EAAE,cAAc;aACtB,CAAC,CAAC;YAEH,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;YAE7B,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,KAAK,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YAED,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC;YAExB,oCAAoC;YACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC/D,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACxC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,CAAC,KAAK,CAAC,oBAAoB,YAAY,EAAE,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC;YAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/file/file-read.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 fileReadTool: UnifiedTool;
+//# sourceMappingURL=file-read.tool.d.ts.map

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

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

package/dist/tools/file/file-read.tool.js

@@ -0,0 +1,270 @@
+/**
+ * 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/>.
+ */
+/**
+ * File Read Tool
+ *
+ * Read file content with encoding detection, line range support,
+ * binary file detection, size limits, and security validation.
+ *
+ * @module tools/file/file-read
+ */
+import { z } from 'zod';
+import { promises as fs } from 'fs';
+import { errorToJsonString } from '../registry.js';
+import { Logger } from '../../utils/logger.js';
+import { fromNodeError } from '../../utils/errors.js';
+import { validatePath, validateFileSize, ValidationError, checkRateLimit, } from '../../utils/validation.js';
+/** Maximum file size to read (5MB) */
+const MAX_FILE_SIZE = 5 * 1024 * 1024;
+/** Common binary file extensions */
+const BINARY_EXTENSIONS = new Set([
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.bmp',
+    '.ico',
+    '.webp',
+    '.svg',
+    '.pdf',
+    '.doc',
+    '.docx',
+    '.xls',
+    '.xlsx',
+    '.ppt',
+    '.pptx',
+    '.zip',
+    '.tar',
+    '.gz',
+    '.rar',
+    '.7z',
+    '.bz2',
+    '.exe',
+    '.dll',
+    '.so',
+    '.dylib',
+    '.bin',
+    '.mp3',
+    '.mp4',
+    '.avi',
+    '.mkv',
+    '.mov',
+    '.wav',
+    '.flac',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.otf',
+    '.eot',
+    '.sqlite',
+    '.db',
+    '.class',
+    '.pyc',
+    '.o',
+    '.a',
+]);
+const schema = z.object({
+    path: z.string().min(1).describe('Absolute or relative file path to read'),
+    startLine: z.number().int().positive().optional().describe('Start line number (1-based)'),
+    endLine: z.number().int().positive().optional().describe('End line number (1-based, inclusive)'),
+    encoding: z
+        .enum(['utf-8', 'utf-16', 'ascii', 'latin1', 'base64'])
+        .default('utf-8')
+        .describe('File encoding'),
+    maxSize: z.number().int().positive().optional().describe('Maximum bytes to read (default: 5MB)'),
+});
+/**
+ * Detect if a file is binary based on extension and content sampling
+ */
+async function isBinaryFile(filePath) {
+    // Check extension first
+    const ext = filePath.toLowerCase().slice(filePath.lastIndexOf('.'));
+    if (BINARY_EXTENSIONS.has(ext)) {
+        return true;
+    }
+    // Sample first 8KB for null bytes (binary indicator)
+    try {
+        const fd = await fs.open(filePath, 'r');
+        const buffer = Buffer.alloc(8192);
+        const { bytesRead } = await fd.read(buffer, 0, 8192, 0);
+        await fd.close();
+        // Check for null bytes (common in binary files)
+        for (let i = 0; i < bytesRead; i++) {
+            if (buffer[i] === 0) {
+                return true;
+            }
+        }
+    }
+    catch {
+        // If we can't read, assume text
+    }
+    return false;
+}
+/**
+ * Get file encoding from Buffer
+ */
+function detectEncoding(buffer) {
+    // Check for BOM markers
+    if (buffer[0] === 0xef && buffer[1] === 0xbb && buffer[2] === 0xbf) {
+        return 'utf-8';
+    }
+    if (buffer[0] === 0xfe && buffer[1] === 0xff) {
+        return 'utf-16be';
+    }
+    if (buffer[0] === 0xff && buffer[1] === 0xfe) {
+        return 'utf-16le';
+    }
+    return 'utf-8'; // Default
+}
+export const fileReadTool = {
+    name: 'file-read',
+    description: 'Read file content with encoding detection, line ranges, and binary detection',
+    zodSchema: schema,
+    skipContextShare: true, // File content may be large
+    execute: async (args) => {
+        const { path: inputPath, startLine, endLine, encoding, maxSize } = args;
+        const maxBytes = maxSize ?? MAX_FILE_SIZE;
+        // Rate limit check
+        if (!checkRateLimit('file-read', { maxRequests: 200, windowMs: 60000 })) {
+            return JSON.stringify({
+                success: false,
+                error: 'Rate limit exceeded for file-read operations',
+                code: 'RATE_LIMIT_EXCEEDED',
+            });
+        }
+        try {
+            // Validate and sanitize the path
+            // Note: requireWithinProject is false to allow reading files from external codebases
+            let validatedPath;
+            try {
+                validatedPath = await validatePath(inputPath, {
+                    allowSymlinks: false,
+                    requireWithinProject: false, // Allow reading any accessible file
+                    allowReadFromBlocked: true, // Allow reading from more places, but not /proc, /sys, /dev
+                    operation: 'read',
+                });
+            }
+            catch (validationError) {
+                if (validationError instanceof ValidationError) {
+                    Logger.warn(`file-read security validation failed: ${validationError.message}`);
+                    return JSON.stringify({
+                        success: false,
+                        error: validationError.message,
+                        code: validationError.code,
+                        path: inputPath,
+                    });
+                }
+                throw validationError;
+            }
+            // Validate file size
+            let fileStats;
+            try {
+                fileStats = await validateFileSize(validatedPath, maxBytes);
+            }
+            catch (validationError) {
+                if (validationError instanceof ValidationError) {
+                    return JSON.stringify({
+                        success: false,
+                        error: validationError.message,
+                        code: validationError.code,
+                        path: validatedPath,
+                    });
+                }
+                throw validationError;
+            }
+            if (!fileStats.isFile) {
+                return JSON.stringify({
+                    success: false,
+                    error: `Path is not a file: ${validatedPath}`,
+                    path: validatedPath,
+                });
+            }
+            // Get file stats for additional metadata
+            const stats = await fs.stat(validatedPath);
+            // Check for binary
+            if (await isBinaryFile(validatedPath)) {
+                return JSON.stringify({
+                    success: false,
+                    error: 'Binary file detected. Use appropriate tools for binary files.',
+                    path: validatedPath,
+                    size: stats.size,
+                    isBinary: true,
+                });
+            }
+            // Read file content
+            const buffer = await fs.readFile(validatedPath);
+            const detectedEncoding = detectEncoding(buffer);
+            const content = buffer.toString(encoding === 'utf-8' ? 'utf8' : encoding);
+            // Handle line ranges
+            if (startLine !== undefined || endLine !== undefined) {
+                const lines = content.split('\n');
+                const start = (startLine ?? 1) - 1; // Convert to 0-based
+                const end = endLine ?? lines.length;
+                if (start >= lines.length) {
+                    return JSON.stringify({
+                        success: false,
+                        error: `Start line ${startLine} exceeds file length (${lines.length} lines)`,
+                        totalLines: lines.length,
+                    });
+                }
+                const selectedLines = lines.slice(start, end);
+                const lineNumbers = selectedLines.map((line, idx) => ({
+                    lineNumber: start + idx + 1,
+                    content: line,
+                }));
+                return JSON.stringify({
+                    success: true,
+                    path: validatedPath,
+                    encoding: detectedEncoding,
+                    totalLines: lines.length,
+                    range: { start: start + 1, end: Math.min(end, lines.length) },
+                    lines: lineNumbers,
+                });
+            }
+            // Return full file content
+            const lines = content.split('\n');
+            return JSON.stringify({
+                success: true,
+                path: validatedPath,
+                encoding: detectedEncoding,
+                size: stats.size,
+                totalLines: lines.length,
+                content,
+                modifiedAt: stats.mtime.toISOString(),
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            Logger.error(`file-read error: ${errorMessage}`);
+            // Convert Node.js errno errors to custom error types
+            const nodeError = error;
+            if (nodeError.code) {
+                const mcpError = fromNodeError(nodeError, inputPath, 'read');
+                return errorToJsonString(mcpError);
+            }
+            // For other errors, return a generic error response
+            return JSON.stringify({
+                success: false,
+                error: errorMessage,
+                code: 'UNKNOWN_ERROR',
+                path: inputPath,
+            });
+        }
+    },
+};
+//# sourceMappingURL=file-read.tool.js.map