kemdicode-mcp 1.15.0

package/dist/utils/process-utils.d.ts

@@ -0,0 +1,196 @@
+/**
+ * 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/>.
+ */
+/**
+ * Get default timeout for process execution (5 minutes)
+ * Uses config which may change at runtime
+ */
+export declare function getDefaultTimeout(): number;
+/**
+ * Get short timeout for quick operations (2 minutes)
+ * Uses config which may change at runtime
+ */
+export declare function getShortTimeout(): number;
+/**
+ * Get long timeout for test/build operations (10 minutes)
+ * Uses config which may change at runtime
+ */
+export declare function getLongTimeout(): number;
+/**
+ * Default timeout for process execution (5 minutes)
+ * @deprecated Use getDefaultTimeout() instead for runtime config support
+ */
+export declare const DEFAULT_TIMEOUT = 300000;
+/**
+ * Short timeout for quick operations (2 minutes)
+ * @deprecated Use getShortTimeout() instead for runtime config support
+ */
+export declare const SHORT_TIMEOUT = 120000;
+/**
+ * Long timeout for test/build operations (10 minutes)
+ * @deprecated Use getLongTimeout() instead for runtime config support
+ */
+export declare const LONG_TIMEOUT = 600000;
+/**
+ * Progress callback type
+ */
+export type ProgressCallback = (output: string) => void;
+/**
+ * Options for spawning a process
+ */
+export interface SpawnProcessOptions {
+    /** Working directory for the command */
+    cwd: string;
+    /** Timeout in milliseconds (default: 5 minutes) */
+    timeout?: number;
+    /** Progress callback for streaming output */
+    onProgress?: ProgressCallback;
+    /** Additional environment variables */
+    env?: Record<string, string>;
+    /** Whether to use shell (default: true for cross-platform compatibility) */
+    shell?: boolean;
+    /** Whether to force color output (default: false) */
+    forceColor?: boolean;
+    /** Whether to set CI environment (default: false) */
+    ci?: boolean;
+}
+/**
+ * Result of a spawned process
+ */
+export interface SpawnResult {
+    /** Combined stdout output */
+    stdout: string;
+    /** Combined stderr output */
+    stderr: string;
+    /** Exit code (null if killed) */
+    exitCode: number | null;
+    /** Whether the process timed out */
+    timedOut: boolean;
+    /** Duration in milliseconds */
+    duration: number;
+}
+/**
+ * Spawn a process with timeout and progress streaming
+ *
+ * @param command - Command to execute
+ * @param args - Command arguments
+ * @param options - Spawn options
+ * @returns Promise resolving to spawn result
+ *
+ * @example
+ * ```typescript
+ * const result = await spawnProcess('npm', ['run', 'build'], {
+ *   cwd: '/path/to/project',
+ *   timeout: 120000,
+ *   onProgress: (output) => console.log(output),
+ * });
+ *
+ * if (result.exitCode === 0) {
+ *   console.log('Build succeeded');
+ * }
+ * ```
+ */
+export declare function spawnProcess(command: string, args: string[], options: SpawnProcessOptions): Promise<SpawnResult>;
+/**
+ * Format duration in milliseconds to human-readable string
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(1500); // '1.50s'
+ * formatDuration(65000); // '1m 5.00s'
+ * ```
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Create a formatted completion message
+ *
+ * @param result - Spawn result
+ * @returns Formatted completion string
+ */
+export declare function formatCompletion(result: SpawnResult): string;
+/**
+ * Run a command and return formatted output with completion message
+ *
+ * @param command - Command to execute
+ * @param args - Command arguments
+ * @param options - Spawn options
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * const output = await runCommand('npm', ['test'], {
+ *   cwd: '/project',
+ *   onProgress,
+ * });
+ * ```
+ */
+export declare function runCommand(command: string, args: string[], options: SpawnProcessOptions): Promise<string>;
+/**
+ * Options for running with auto-detection
+ */
+export interface DetectableRunner<T> {
+    /** Name of the runner */
+    name: string;
+    /** Config files to detect this runner */
+    configFiles: string[];
+    /** The configuration object */
+    config: T;
+}
+/**
+ * Detect a runner from config files
+ *
+ * @param cwd - Working directory
+ * @param runners - List of runners to check
+ * @param checkExists - Function to check if file exists
+ * @returns Detected runner or null
+ *
+ * @example
+ * ```typescript
+ * const runner = await detectRunner(cwd, TEST_FRAMEWORKS, existsSync);
+ * if (!runner) {
+ *   return 'No test framework detected';
+ * }
+ * ```
+ */
+export declare function detectRunner<T>(cwd: string, runners: DetectableRunner<T>[], checkExists: (path: string) => boolean): T | null;
+/**
+ * Get runner by name from a list
+ *
+ * @param name - Runner name
+ * @param runners - List of runners
+ * @returns Runner config or null
+ */
+export declare function getRunnerByName<T>(name: string, runners: DetectableRunner<T>[]): T | null;
+/**
+ * Validate working directory exists
+ *
+ * @param cwd - Directory path
+ * @param checkExists - Function to check if directory exists
+ * @throws Error if directory does not exist
+ */
+export declare function validateCwd(cwd: string, checkExists: (path: string) => boolean): void;
+/**
+ * Get the working directory, defaulting to process.cwd()
+ *
+ * @param cwd - Optional working directory from args
+ * @returns Working directory path
+ */
+export declare function getCwd(cwd?: string): string;
+//# sourceMappingURL=process-utils.d.ts.map

package/dist/utils/process-utils.d.ts.map

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

package/dist/utils/process-utils.js

@@ -0,0 +1,302 @@
+/**
+ * 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/>.
+ */
+/**
+ * Process Utilities
+ *
+ * Shared utilities for process execution across project tools.
+ * Provides spawn helpers with timeout, progress streaming,
+ * and common process patterns.
+ *
+ * @module utils/process-utils
+ */
+import { spawn } from 'child_process';
+import { Logger } from './logger.js';
+import { config } from '../config/index.js';
+/**
+ * Get default timeout for process execution (5 minutes)
+ * Uses config which may change at runtime
+ */
+export function getDefaultTimeout() {
+    return config.get('timeouts').command;
+}
+/**
+ * Get short timeout for quick operations (2 minutes)
+ * Uses config which may change at runtime
+ */
+export function getShortTimeout() {
+    return config.get('timeouts').short;
+}
+/**
+ * Get long timeout for test/build operations (10 minutes)
+ * Uses config which may change at runtime
+ */
+export function getLongTimeout() {
+    return config.get('timeouts').long;
+}
+/**
+ * Default timeout for process execution (5 minutes)
+ * @deprecated Use getDefaultTimeout() instead for runtime config support
+ */
+export const DEFAULT_TIMEOUT = 300_000;
+/**
+ * Short timeout for quick operations (2 minutes)
+ * @deprecated Use getShortTimeout() instead for runtime config support
+ */
+export const SHORT_TIMEOUT = 120_000;
+/**
+ * Long timeout for test/build operations (10 minutes)
+ * @deprecated Use getLongTimeout() instead for runtime config support
+ */
+export const LONG_TIMEOUT = 600_000;
+/**
+ * Spawn a process with timeout and progress streaming
+ *
+ * @param command - Command to execute
+ * @param args - Command arguments
+ * @param options - Spawn options
+ * @returns Promise resolving to spawn result
+ *
+ * @example
+ * ```typescript
+ * const result = await spawnProcess('npm', ['run', 'build'], {
+ *   cwd: '/path/to/project',
+ *   timeout: 120000,
+ *   onProgress: (output) => console.log(output),
+ * });
+ *
+ * if (result.exitCode === 0) {
+ *   console.log('Build succeeded');
+ * }
+ * ```
+ */
+export async function spawnProcess(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const startTime = Date.now();
+        const timeout = options.timeout ?? getDefaultTimeout();
+        Logger.debug(`Running: ${command} ${args.join(' ')} in ${options.cwd}`);
+        options.onProgress?.(`$ ${command} ${args.join(' ')}\n\n`);
+        // Build environment
+        const env = { ...process.env, ...options.env };
+        if (options.forceColor) {
+            env.FORCE_COLOR = '1';
+        }
+        if (options.ci) {
+            env.CI = 'true';
+        }
+        const spawnOptions = {
+            cwd: options.cwd,
+            shell: options.shell ?? true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env,
+        };
+        const proc = spawn(command, args, spawnOptions);
+        let stdout = '';
+        let stderr = '';
+        let done = false;
+        // Setup timeout
+        const timer = setTimeout(() => {
+            if (done)
+                return;
+            done = true;
+            killProcess(proc);
+            resolve({
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                exitCode: null,
+                timedOut: true,
+                duration: Date.now() - startTime,
+            });
+        }, timeout);
+        // Capture stdout
+        proc.stdout?.on('data', (data) => {
+            const chunk = data.toString();
+            stdout += chunk;
+            options.onProgress?.(chunk);
+        });
+        // Capture stderr
+        proc.stderr?.on('data', (data) => {
+            const chunk = data.toString();
+            stderr += chunk;
+            options.onProgress?.(chunk);
+        });
+        // Handle spawn error
+        proc.on('error', (err) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            reject(new Error(`Failed to spawn ${command}: ${err.message}`));
+        });
+        // Handle process exit
+        proc.on('close', (code) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            resolve({
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                exitCode: code,
+                timedOut: false,
+                duration: Date.now() - startTime,
+            });
+        });
+    });
+}
+/**
+ * Kill a process gracefully with SIGTERM, then SIGKILL after 5 seconds
+ *
+ * @param proc - Process to kill
+ */
+function killProcess(proc) {
+    try {
+        proc.kill('SIGTERM');
+        setTimeout(() => {
+            try {
+                proc.kill('SIGKILL');
+            }
+            catch {
+                // Process may have already exited
+            }
+        }, 5000);
+    }
+    catch {
+        // Process may have already exited
+    }
+}
+/**
+ * Format duration in milliseconds to human-readable string
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(1500); // '1.50s'
+ * formatDuration(65000); // '1m 5.00s'
+ * ```
+ */
+export function formatDuration(ms) {
+    const seconds = ms / 1000;
+    if (seconds < 60) {
+        return `${seconds.toFixed(2)}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${minutes}m ${remainingSeconds.toFixed(2)}s`;
+}
+/**
+ * Create a formatted completion message
+ *
+ * @param result - Spawn result
+ * @returns Formatted completion string
+ */
+export function formatCompletion(result) {
+    const duration = formatDuration(result.duration);
+    if (result.timedOut) {
+        return `\n\n[TIMEOUT: Exceeded ${formatDuration(result.duration)} limit]`;
+    }
+    if (result.exitCode === 0) {
+        return `\n\n[Completed in ${duration}]`;
+    }
+    return `\n\n[Exit code: ${result.exitCode}, Duration: ${duration}]`;
+}
+/**
+ * Run a command and return formatted output with completion message
+ *
+ * @param command - Command to execute
+ * @param args - Command arguments
+ * @param options - Spawn options
+ * @returns Formatted output string
+ *
+ * @example
+ * ```typescript
+ * const output = await runCommand('npm', ['test'], {
+ *   cwd: '/project',
+ *   onProgress,
+ * });
+ * ```
+ */
+export async function runCommand(command, args, options) {
+    const result = await spawnProcess(command, args, options);
+    let output = result.stdout;
+    if (result.stderr) {
+        output += (output ? '\n\nSTDERR:\n' : '') + result.stderr;
+    }
+    return output + formatCompletion(result);
+}
+/**
+ * Detect a runner from config files
+ *
+ * @param cwd - Working directory
+ * @param runners - List of runners to check
+ * @param checkExists - Function to check if file exists
+ * @returns Detected runner or null
+ *
+ * @example
+ * ```typescript
+ * const runner = await detectRunner(cwd, TEST_FRAMEWORKS, existsSync);
+ * if (!runner) {
+ *   return 'No test framework detected';
+ * }
+ * ```
+ */
+export function detectRunner(cwd, runners, checkExists) {
+    for (const runner of runners) {
+        for (const configFile of runner.configFiles) {
+            const configPath = `${cwd}/${configFile}`;
+            if (checkExists(configPath)) {
+                return runner.config;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Get runner by name from a list
+ *
+ * @param name - Runner name
+ * @param runners - List of runners
+ * @returns Runner config or null
+ */
+export function getRunnerByName(name, runners) {
+    const runner = runners.find((r) => r.name === name);
+    return runner?.config ?? null;
+}
+/**
+ * Validate working directory exists
+ *
+ * @param cwd - Directory path
+ * @param checkExists - Function to check if directory exists
+ * @throws Error if directory does not exist
+ */
+export function validateCwd(cwd, checkExists) {
+    if (!checkExists(cwd)) {
+        throw new Error(`Directory not found: ${cwd}`);
+    }
+}
+/**
+ * Get the working directory, defaulting to process.cwd()
+ *
+ * @param cwd - Optional working directory from args
+ * @returns Working directory path
+ */
+export function getCwd(cwd) {
+    return cwd || process.cwd();
+}
+//# sourceMappingURL=process-utils.js.map

package/dist/utils/process-utils.js.map

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

package/dist/utils/projectContext.enhanced.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 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/>.
+ */
+/**
+ * Enhanced project context with auto-detected properties
+ * @interface EnhancedProjectContext
+ */
+export interface EnhancedProjectContext {
+    projectRoot: string;
+    language: string;
+    framework: string;
+    runtime: string;
+    packageManager: string;
+    mainTechnologies: string[];
+    structure: string;
+    conventions: string[];
+    commonPatterns: string[];
+    externalIntegrations: string[];
+    testingStack: string[];
+    recentlyModifiedFiles: string[];
+}
+/**
+ * Set the project root directory programmatically
+ * @param {string} path - Absolute path to project root
+ */
+export declare function setProjectRoot(path: string): void;
+/**
+ * Get the current project root directory
+ * @returns {string} Absolute path to project root
+ */
+export declare function getCurrentProjectRoot(): string;
+/**
+ * Get enhanced project context with auto-detection
+ * Results are cached for 5 minutes for performance
+ * @returns {EnhancedProjectContext} Full project context object
+ */
+export declare function getEnhancedProjectContext(): EnhancedProjectContext;
+/**
+ * Format project context as markdown for LLM prompts
+ * @param {EnhancedProjectContext} context - Project context object
+ * @returns {string} Formatted markdown string
+ */
+export declare function formatEnhancedContextForPrompt(context: EnhancedProjectContext): string;
+/**
+ * Get formatted context string ready for prompt injection
+ * Convenience wrapper around getEnhancedProjectContext + formatEnhancedContextForPrompt
+ * @returns {string} Formatted markdown context string
+ */
+export declare function getEnhancedContextString(): string;
+/** @deprecated Use string type directly */
+export type ProjectType = string;
+/**
+ * Clear all cached project context data
+ * Call this when project files change significantly
+ */
+export declare function clearProjectContextCache(): void;
+//# sourceMappingURL=projectContext.enhanced.d.ts.map

package/dist/utils/projectContext.enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectContext.enhanced.d.ts","sourceRoot":"","sources":["../../src/utils/projectContext.enhanced.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAwBH;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAsGD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAunBD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,sBAAsB,CA2BlE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CA8CtF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}