kemdicode-mcp 1.15.0

package/dist/tools/project/run-lint.tool.js

@@ -0,0 +1,279 @@
+/**
+ * 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/>.
+ */
+/**
+ * Run Lint Tool
+ *
+ * Executes ESLint, PHP_CodeSniffer, or PHPStan
+ * and formats the output nicely.
+ *
+ * @module tools/project/run-lint
+ */
+import { z } from 'zod';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { spawnProcess, getCwd, validateCwd, SHORT_TIMEOUT, } from '../../utils/process-utils.js';
+const schema = z.object({
+    cwd: z.string().optional().describe('Working directory (defaults to current directory)'),
+    linter: z
+        .enum(['auto', 'eslint', 'phpcs', 'phpstan', 'prettier'])
+        .default('auto')
+        .describe('Linter to use'),
+    fix: z.boolean().default(false).describe('Auto-fix issues (if supported)'),
+    files: z.string().optional().describe('Specific files/directories to lint'),
+    timeout: z.number().default(120000).describe('Timeout in milliseconds (default: 2 minutes)'),
+});
+/**
+ * Format ESLint output
+ */
+function formatESLintOutput(output) {
+    // ESLint already has good formatting, just clean it up
+    const lines = output.split('\n');
+    const result = [];
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const line of lines) {
+        if (line.includes('error'))
+            errorCount++;
+        if (line.includes('warning'))
+            warningCount++;
+        result.push(line);
+    }
+    if (errorCount === 0 && warningCount === 0 && !output.includes('problem')) {
+        return 'No linting issues found';
+    }
+    return result.join('\n');
+}
+/**
+ * Format PHPCS output
+ */
+function formatPHPCSOutput(output) {
+    // Parse PHPCS output
+    const lines = [];
+    let currentFile = '';
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const line of output.split('\n')) {
+        // File header
+        if (line.startsWith('FILE:')) {
+            currentFile = line.replace('FILE:', '').trim();
+            lines.push(`\n## ${currentFile}`);
+            continue;
+        }
+        // Error/warning line
+        const match = line.match(/^\s*(\d+)\s*\|\s*(ERROR|WARNING)\s*\|\s*(.+)$/);
+        if (match) {
+            const [, lineNum, severity, message] = match;
+            if (severity === 'ERROR')
+                errorCount++;
+            if (severity === 'WARNING')
+                warningCount++;
+            lines.push(`  Line ${lineNum}: [${severity}] ${message}`);
+        }
+    }
+    if (errorCount === 0 && warningCount === 0) {
+        return 'No PHPCS issues found';
+    }
+    lines.push(`\n---\nSummary: ${errorCount} error(s), ${warningCount} warning(s)`);
+    return lines.join('\n');
+}
+/**
+ * Format PHPStan output
+ */
+function formatPHPStanOutput(output) {
+    const lines = [];
+    let errorCount = 0;
+    // Try to parse JSON output first
+    try {
+        const jsonMatch = output.match(/\{[\s\S]*"totals"[\s\S]*\}/);
+        if (jsonMatch) {
+            const data = JSON.parse(jsonMatch[0]);
+            if (data.totals) {
+                errorCount = data.totals.errors || 0;
+            }
+            if (data.files) {
+                for (const [file, fileData] of Object.entries(data.files)) {
+                    const messages = fileData
+                        .messages;
+                    if (messages && messages.length > 0) {
+                        lines.push(`\n## ${file}`);
+                        for (const msg of messages) {
+                            lines.push(`  Line ${msg.line}: ${msg.message}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Fallback: return raw output
+        return output;
+    }
+    if (errorCount === 0 && lines.length === 0) {
+        return 'No PHPStan issues found';
+    }
+    lines.unshift(`# PHPStan Analysis\nFound ${errorCount} issue(s)`);
+    return lines.join('\n');
+}
+/**
+ * Format Prettier output
+ */
+function formatPrettierOutput(output) {
+    if (!output.trim() || output.includes('All matched files use Prettier code style')) {
+        return 'No formatting issues found';
+    }
+    const filesWithIssues = output
+        .split('\n')
+        .filter((line) => line.trim() && !line.startsWith('Checking'))
+        .filter((line) => line.match(/\.\w+$/));
+    if (filesWithIssues.length === 0) {
+        return 'No formatting issues found';
+    }
+    return `# Prettier Check\nFiles needing formatting:\n${filesWithIssues.map((f) => `- ${f}`).join('\n')}`;
+}
+const LINTERS = [
+    {
+        name: 'eslint',
+        configFiles: [
+            '.eslintrc',
+            '.eslintrc.js',
+            '.eslintrc.json',
+            '.eslintrc.yml',
+            'eslint.config.js',
+            'eslint.config.mjs',
+        ],
+        command: 'npx',
+        args: ['eslint', '.', '--ext', '.js,.jsx,.ts,.tsx', '--format', 'stylish'],
+        fixArgs: ['eslint', '.', '--ext', '.js,.jsx,.ts,.tsx', '--fix'],
+        formatOutput: formatESLintOutput,
+    },
+    {
+        name: 'phpcs',
+        configFiles: ['phpcs.xml', 'phpcs.xml.dist', '.phpcs.xml'],
+        command: 'vendor/bin/phpcs',
+        args: ['--standard=PSR12'],
+        fixArgs: undefined, // Use phpcbf instead
+        formatOutput: formatPHPCSOutput,
+    },
+    {
+        name: 'phpstan',
+        configFiles: ['phpstan.neon', 'phpstan.neon.dist'],
+        command: 'vendor/bin/phpstan',
+        args: ['analyse', '--error-format=json', '--no-progress'],
+        formatOutput: formatPHPStanOutput,
+    },
+    {
+        name: 'prettier',
+        configFiles: ['.prettierrc', '.prettierrc.js', '.prettierrc.json', 'prettier.config.js'],
+        command: 'npx',
+        args: ['prettier', '--check', '.'],
+        fixArgs: ['prettier', '--write', '.'],
+        formatOutput: formatPrettierOutput,
+    },
+];
+/**
+ * Detect linter for the project
+ */
+function detectLinter(cwd) {
+    for (const linter of LINTERS) {
+        for (const configFile of linter.configFiles) {
+            if (existsSync(join(cwd, configFile))) {
+                return linter;
+            }
+        }
+    }
+    // Fallback: check package.json for eslint
+    if (existsSync(join(cwd, 'package.json'))) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const pkg = require(join(cwd, 'package.json'));
+            if (pkg.devDependencies?.eslint || pkg.dependencies?.eslint) {
+                return LINTERS.find((l) => l.name === 'eslint') || null;
+            }
+            if (pkg.devDependencies?.prettier || pkg.dependencies?.prettier) {
+                return LINTERS.find((l) => l.name === 'prettier') || null;
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return null;
+}
+/**
+ * Get linter by name
+ */
+function getLinter(name) {
+    return LINTERS.find((l) => l.name === name) || null;
+}
+/**
+ * Execute linter using shared process utilities
+ */
+async function executeLinter(linter, cwd, fix, files, timeout, _onProgress) {
+    let args = fix && linter.fixArgs ? [...linter.fixArgs] : [...linter.args];
+    // Add specific files if provided
+    if (files) {
+        args = args.filter((a) => a !== '.');
+        args.push(...files.split(' ').filter(Boolean));
+    }
+    // Note: we don't pass onProgress to spawnProcess for linters
+    // because we want to format the output before returning
+    const result = await spawnProcess(linter.command, args, {
+        cwd,
+        timeout,
+        forceColor: false, // Disable colors for parsing
+    });
+    // Linters often exit with code 1 when issues are found
+    const combined = result.stdout + result.stderr;
+    const formatted = linter.formatOutput(combined);
+    if (result.timedOut) {
+        return formatted + `\n\n[TIMEOUT: Linting exceeded ${timeout / 1000}s limit]`;
+    }
+    if (fix) {
+        return formatted + '\n\n[Auto-fix applied]';
+    }
+    return formatted;
+}
+export const runLintTool = {
+    name: 'run-lint',
+    description: 'Run ESLint, PHPCS, PHPStan, or Prettier with formatted output',
+    zodSchema: schema,
+    execute: async (args, onProgress) => {
+        const cwd = getCwd(args.cwd);
+        const linterChoice = args.linter || 'auto';
+        const fix = Boolean(args.fix);
+        const files = args.files;
+        const timeout = args.timeout || SHORT_TIMEOUT;
+        validateCwd(cwd, existsSync);
+        let linter;
+        if (linterChoice === 'auto') {
+            linter = detectLinter(cwd);
+            if (!linter) {
+                return `No linter detected in ${cwd}\nSearched for: ESLint, PHPCS, PHPStan, Prettier config files`;
+            }
+        }
+        else {
+            linter = getLinter(linterChoice);
+            if (!linter) {
+                throw new Error(`Unknown linter: ${linterChoice}`);
+            }
+        }
+        onProgress?.(`Running ${linter.name}${fix ? ' with auto-fix' : ''}...\n\n`);
+        return executeLinter(linter, cwd, fix, files, timeout, onProgress);
+    },
+};
+//# sourceMappingURL=run-lint.tool.js.map

package/dist/tools/project/run-lint.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-lint.tool.js","sourceRoot":"","sources":["../../../src/tools/project/run-lint.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,MAAM,EACN,WAAW,EACX,aAAa,GAEd,MAAM,8BAA8B,CAAC;AActC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACxF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;SACxD,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,eAAe,CAAC;IAC5B,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CAC7F,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACxC,uDAAuD;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,UAAU,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,YAAY,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1E,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAc;IACvC,qBAAqB;IACrB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,cAAc;QACd,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,QAAQ,WAAW,EAAE,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QAED,qBAAqB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC1E,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;YAC7C,IAAI,QAAQ,KAAK,OAAO;gBAAE,UAAU,EAAE,CAAC;YACvC,IAAI,QAAQ,KAAK,SAAS;gBAAE,YAAY,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,MAAM,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,mBAAmB,UAAU,cAAc,YAAY,aAAa,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,iCAAiC;IACjC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC7D,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1D,MAAM,QAAQ,GAAI,QAAoE;yBACnF,QAAQ,CAAC;oBACZ,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;wBAC3B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;4BAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;wBACnD,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,6BAA6B,UAAU,WAAW,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,MAAc;IAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,2CAA2C,CAAC,EAAE,CAAC;QACnF,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,MAAM,eAAe,GAAG,MAAM;SAC3B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1C,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,OAAO,gDAAgD,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3G,CAAC;AAED,MAAM,OAAO,GAAa;IACxB;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;YACX,WAAW;YACX,cAAc;YACd,gBAAgB;YAChB,eAAe;YACf,kBAAkB;YAClB,mBAAmB;SACpB;QACD,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,SAAS,CAAC;QAC1E,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC;QAC/D,YAAY,EAAE,kBAAkB;KACjC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,YAAY,CAAC;QAC1D,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,CAAC,kBAAkB,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,qBAAqB;QACzC,YAAY,EAAE,iBAAiB;KAChC;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,CAAC,cAAc,EAAE,mBAAmB,CAAC;QAClD,OAAO,EAAE,oBAAoB;QAC7B,IAAI,EAAE,CAAC,SAAS,EAAE,qBAAqB,EAAE,eAAe,CAAC;QACzD,YAAY,EAAE,mBAAmB;KAClC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,CAAC;QACxF,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC;QAClC,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC;QACrC,YAAY,EAAE,oBAAoB;KACnC;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;gBACtC,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,iEAAiE;YACjE,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YAC/C,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;gBAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;YAC1D,CAAC;YACD,IAAI,GAAG,CAAC,eAAe,EAAE,QAAQ,IAAI,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC;gBAChE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,IAAI,CAAC;YAC5D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,MAAc,EACd,GAAW,EACX,GAAY,EACZ,KAAyB,EACzB,OAAe,EACf,WAA8B;IAE9B,IAAI,IAAI,GAAG,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE1E,iCAAiC;IACjC,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,6DAA6D;IAC7D,wDAAwD;IACxD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE;QACtD,GAAG;QACH,OAAO;QACP,UAAU,EAAE,KAAK,EAAE,6BAA6B;KACjD,CAAC,CAAC;IAEH,uDAAuD;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,SAAS,GAAG,kCAAkC,OAAO,GAAG,IAAI,UAAU,CAAC;IAChF,CAAC;IAED,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,SAAS,GAAG,wBAAwB,CAAC;IAC9C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,+DAA+D;IAC5E,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAyB,CAAC,CAAC;QACnD,MAAM,YAAY,GAAI,IAAI,CAAC,MAAiB,IAAI,MAAM,CAAC;QACvD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAA2B,CAAC;QAC/C,MAAM,OAAO,GAAI,IAAI,CAAC,OAAkB,IAAI,aAAa,CAAC;QAE1D,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAE7B,IAAI,MAAqB,CAAC;QAE1B,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,yBAAyB,GAAG,+DAA+D,CAAC;YACrG,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,YAAY,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,UAAU,EAAE,CAAC,WAAW,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAE5E,OAAO,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;CACF,CAAC"}

package/dist/tools/project/run-script.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 runScriptTool: UnifiedTool;
+//# sourceMappingURL=run-script.tool.d.ts.map

package/dist/tools/project/run-script.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-script.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/project/run-script.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAwH7C,eAAO,MAAM,aAAa,EAAE,WAiC3B,CAAC"}

package/dist/tools/project/run-script.tool.js

@@ -0,0 +1,141 @@
+/**
+ * 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/>.
+ */
+/**
+ * Run Script Tool
+ *
+ * Executes package manager scripts (npm, yarn, pnpm, composer)
+ * with streaming output and timeout support.
+ *
+ * @module tools/project/run-script
+ */
+import { z } from 'zod';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { spawnProcess, formatCompletion, getCwd, validateCwd, DEFAULT_TIMEOUT, } from '../../utils/process-utils.js';
+const PACKAGE_MANAGERS = [
+    {
+        name: 'pnpm',
+        configFile: 'pnpm-lock.yaml',
+        command: 'pnpm',
+        runPrefix: ['run'],
+        listCommand: ['run', '--help'],
+    },
+    {
+        name: 'yarn',
+        configFile: 'yarn.lock',
+        command: 'yarn',
+        runPrefix: ['run'],
+        listCommand: ['run', '--list'],
+    },
+    {
+        name: 'npm',
+        configFile: 'package-lock.json',
+        command: 'npm',
+        runPrefix: ['run'],
+        listCommand: ['run'],
+    },
+    {
+        name: 'composer',
+        configFile: 'composer.json',
+        command: 'composer',
+        runPrefix: ['run-script'],
+        listCommand: ['run-script', '--list'],
+    },
+];
+const schema = z.object({
+    script: z.string().min(1).describe('Script name to execute (e.g., "build", "test", "dev")'),
+    cwd: z.string().optional().describe('Working directory (defaults to current directory)'),
+    args: z.string().optional().describe('Additional arguments to pass to the script'),
+    timeout: z.number().default(300000).describe('Timeout in milliseconds (default: 5 minutes)'),
+    packageManager: z
+        .enum(['auto', 'npm', 'yarn', 'pnpm', 'composer'])
+        .default('auto')
+        .describe('Package manager to use'),
+});
+/**
+ * Detect the package manager used in the project
+ */
+function detectPackageManager(cwd) {
+    for (const pm of PACKAGE_MANAGERS) {
+        const lockFile = join(cwd, pm.configFile);
+        if (existsSync(lockFile)) {
+            return pm;
+        }
+    }
+    // Fallback: check for package.json (npm) or composer.json
+    if (existsSync(join(cwd, 'package.json'))) {
+        return PACKAGE_MANAGERS.find((pm) => pm.name === 'npm') || null;
+    }
+    if (existsSync(join(cwd, 'composer.json'))) {
+        return PACKAGE_MANAGERS.find((pm) => pm.name === 'composer') || null;
+    }
+    return null;
+}
+/**
+ * Get package manager by name
+ */
+function getPackageManager(name) {
+    return PACKAGE_MANAGERS.find((pm) => pm.name === name) || null;
+}
+/**
+ * Execute a script with streaming output using shared process utilities
+ */
+async function executeScript(pm, script, cwd, additionalArgs, timeout, onProgress) {
+    const args = [...pm.runPrefix, script, ...additionalArgs];
+    const result = await spawnProcess(pm.command, args, {
+        cwd,
+        timeout,
+        onProgress,
+        forceColor: true,
+        ci: true,
+    });
+    let output = result.stdout;
+    if (result.stderr) {
+        output += (output ? '\n\nSTDERR:\n' : '') + result.stderr;
+    }
+    return output + formatCompletion(result);
+}
+export const runScriptTool = {
+    name: 'run-script',
+    description: 'Execute npm/yarn/pnpm/composer scripts with streaming output',
+    zodSchema: schema,
+    execute: async (args, onProgress) => {
+        const script = String(args.script);
+        const cwd = getCwd(args.cwd);
+        const timeout = args.timeout || DEFAULT_TIMEOUT;
+        const pmChoice = args.packageManager || 'auto';
+        const additionalArgs = args.args ? String(args.args).split(' ').filter(Boolean) : [];
+        validateCwd(cwd, existsSync);
+        let pm;
+        if (pmChoice === 'auto') {
+            pm = detectPackageManager(cwd);
+            if (!pm) {
+                throw new Error(`No package manager detected in ${cwd}. Expected package.json or composer.json`);
+            }
+        }
+        else {
+            pm = getPackageManager(pmChoice);
+            if (!pm) {
+                throw new Error(`Unknown package manager: ${pmChoice}`);
+            }
+        }
+        onProgress?.(`Using ${pm.name} to run "${script}"...\n\n`);
+        return executeScript(pm, script, cwd, additionalArgs, timeout, onProgress);
+    },
+};
+//# sourceMappingURL=run-script.tool.js.map

package/dist/tools/project/run-script.tool.js.map

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

package/dist/tools/project/run-tests.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 runTestsTool: UnifiedTool;
+//# sourceMappingURL=run-tests.tool.d.ts.map

package/dist/tools/project/run-tests.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/project/run-tests.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA2X7C,eAAO,MAAM,YAAY,EAAE,WA0C1B,CAAC"}