kemdicode-mcp 1.15.0

package/dist/server/session-server.d.ts

@@ -0,0 +1,76 @@
+/**
+ * KemdiCode MCP Server - Session 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.
+ */
+/**
+ * Session Server Module
+ *
+ * MCP session management, transport handling, and CWD resolution.
+ *
+ * @module server/session-server
+ */
+import type { IncomingMessage } from 'node:http';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { type SessionConfig } from './types.js';
+import type { ToolArguments } from '../tools/registry.js';
+/**
+ * Resolve CWD for a request using priority order:
+ * 1. X-Project-Path header
+ * 2. cwd in tool arguments
+ * 3. KEMDICODE_PROJECT_PATH env variable
+ * 4. Session stored CWD
+ * 5. process.cwd() fallback
+ */
+export declare function resolveCwd(req: IncomingMessage, sessionId?: string, args?: ToolArguments): string;
+/**
+ * Get session configuration by ID
+ * @param sessionId - Session identifier
+ * @returns Session configuration if exists
+ */
+export declare function getSessionConfig(sessionId: string): SessionConfig | undefined;
+/**
+ * Set session configuration
+ * @param sessionId - Session identifier
+ * @param config - Session configuration
+ */
+export declare function setSessionConfig(sessionId: string, config: SessionConfig): void;
+/**
+ * Delete session configuration
+ * @param sessionId - Session identifier
+ */
+export declare function deleteSessionConfig(sessionId: string): void;
+/**
+ * Get all session configurations (for health check)
+ * @returns Map of session configs
+ */
+export declare function getAllSessionConfigs(): Map<string, SessionConfig>;
+/**
+ * Create and configure a session-specific MCP server
+ * This function encapsulates the session server setup to avoid code duplication
+ * @param _sessionId - Unique session identifier
+ * @returns Configured MCP server instance
+ */
+export declare function createSessionServer(_sessionId: string): Server;
+/**
+ * Create or get transport for a session
+ * @param sessionId - Session identifier
+ * @param transports - Map of active transports
+ * @param req - HTTP request for CWD resolution
+ * @returns Transport and whether it was newly created
+ */
+export declare function getOrCreateTransport(sessionId: string, transports: Map<string, StreamableHTTPServerTransport>, req: IncomingMessage): Promise<{
+    transport: StreamableHTTPServerTransport;
+    isNew: boolean;
+}>;
+/**
+ * Generate a new session ID
+ * @returns New session ID
+ */
+export declare function generateSessionId(): string;
+//# sourceMappingURL=session-server.d.ts.map

package/dist/server/session-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-server.d.ts","sourceRoot":"","sources":["../../src/server/session-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAkBnG,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CA2BjG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAE/E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA4D9D;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,EACtD,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC;IAAE,SAAS,EAAE,6BAA6B,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAmCvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/server/session-server.js

@@ -0,0 +1,186 @@
+/**
+ * KemdiCode MCP Server - Session 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.
+ */
+import { randomUUID } from 'node:crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { Logger } from '../utils/logger.js';
+import { getToolDefinitions, getPromptDefinitions, executeTool, toolExists, getPromptMessage, } from '../tools/index.js';
+import { startProgress, stopProgress, updateProgressOutput } from './progress.js';
+import { VERSION } from './types.js';
+/** Map of session IDs to their configurations */
+const sessionConfigs = new Map();
+/**
+ * Resolve CWD for a request using priority order:
+ * 1. X-Project-Path header
+ * 2. cwd in tool arguments
+ * 3. KEMDICODE_PROJECT_PATH env variable
+ * 4. Session stored CWD
+ * 5. process.cwd() fallback
+ */
+export function resolveCwd(req, sessionId, args) {
+    // Priority 1: X-Project-Path header
+    const headerPath = req.headers['x-project-path'];
+    if (headerPath && typeof headerPath === 'string') {
+        return headerPath;
+    }
+    // Priority 2: cwd in tool arguments
+    if (args?.cwd && typeof args.cwd === 'string') {
+        return args.cwd;
+    }
+    // Priority 3: Environment variable
+    if (process.env.KEMDICODE_PROJECT_PATH) {
+        return process.env.KEMDICODE_PROJECT_PATH;
+    }
+    // Priority 4: Session stored CWD
+    if (sessionId) {
+        const sessionConfig = sessionConfigs.get(sessionId);
+        if (sessionConfig?.cwd) {
+            return sessionConfig.cwd;
+        }
+    }
+    // Priority 5: Fallback
+    return process.cwd();
+}
+/**
+ * Get session configuration by ID
+ * @param sessionId - Session identifier
+ * @returns Session configuration if exists
+ */
+export function getSessionConfig(sessionId) {
+    return sessionConfigs.get(sessionId);
+}
+/**
+ * Set session configuration
+ * @param sessionId - Session identifier
+ * @param config - Session configuration
+ */
+export function setSessionConfig(sessionId, config) {
+    sessionConfigs.set(sessionId, config);
+}
+/**
+ * Delete session configuration
+ * @param sessionId - Session identifier
+ */
+export function deleteSessionConfig(sessionId) {
+    sessionConfigs.delete(sessionId);
+}
+/**
+ * Get all session configurations (for health check)
+ * @returns Map of session configs
+ */
+export function getAllSessionConfigs() {
+    return sessionConfigs;
+}
+/**
+ * Create and configure a session-specific MCP server
+ * This function encapsulates the session server setup to avoid code duplication
+ * @param _sessionId - Unique session identifier
+ * @returns Configured MCP server instance
+ */
+export function createSessionServer(_sessionId) {
+    const sessionServer = new Server({ name: 'kemdicode-mcp', version: VERSION }, { capabilities: { tools: {}, prompts: {}, logging: {} } });
+    // Handler: List available tools
+    sessionServer.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: getToolDefinitions(),
+    }));
+    // Handler: Execute tool
+    sessionServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: rawArgs } = request.params;
+        if (!toolExists(name))
+            throw new Error(`Unknown tool: ${name}`);
+        const progressToken = request.params._meta
+            ?.progressToken;
+        const progressData = startProgress(name, progressToken, sessionServer);
+        try {
+            const args = rawArgs || {};
+            Logger.toolInvocation(name, args);
+            const result = await executeTool(name, args, (output) => {
+                updateProgressOutput(progressData.requestId, output);
+            });
+            stopProgress(progressData, true);
+            return { content: [{ type: 'text', text: result }], isError: false };
+        }
+        catch (error) {
+            stopProgress(progressData, false);
+            Logger.error(`Tool '${name}' error:`, error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Handler: List prompts
+    sessionServer.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: getPromptDefinitions(),
+    }));
+    // Handler: Get prompt message
+    sessionServer.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const message = getPromptMessage(request.params.name, request.params.arguments || {});
+        if (!message)
+            throw new Error(`Unknown prompt: ${request.params.name}`);
+        return {
+            messages: [{ role: 'user', content: { type: 'text', text: message } }],
+        };
+    });
+    return sessionServer;
+}
+/**
+ * Create or get transport for a session
+ * @param sessionId - Session identifier
+ * @param transports - Map of active transports
+ * @param req - HTTP request for CWD resolution
+ * @returns Transport and whether it was newly created
+ */
+export async function getOrCreateTransport(sessionId, transports, req) {
+    let transport = transports.get(sessionId);
+    let isNew = false;
+    if (!transport) {
+        isNew = true;
+        transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => sessionId,
+        });
+        const sessionServer = createSessionServer(sessionId);
+        await sessionServer.connect(transport);
+        // Store session config with resolved CWD
+        const cwd = resolveCwd(req, sessionId);
+        sessionConfigs.set(sessionId, {
+            sessionId,
+            cwd,
+        });
+        transports.set(sessionId, transport);
+        Logger.debug(`New session: ${sessionId} (cwd: ${cwd})`);
+    }
+    else {
+        // Update CWD if X-Project-Path header is present
+        const headerPath = req.headers['x-project-path'];
+        if (headerPath && typeof headerPath === 'string') {
+            const config = sessionConfigs.get(sessionId);
+            if (config) {
+                config.cwd = headerPath;
+                Logger.debug(`Updated session ${sessionId} cwd: ${headerPath}`);
+            }
+        }
+    }
+    return { transport, isNew };
+}
+/**
+ * Generate a new session ID
+ * @returns New session ID
+ */
+export function generateSessionId() {
+    return randomUUID();
+}
+//# sourceMappingURL=session-server.js.map

package/dist/server/session-server.js.map

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

package/dist/server/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * KemdiCode MCP Server - Server Types
+ * 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.
+ */
+/**
+ * Server Types Module
+ *
+ * Type definitions for HTTP server, SSE, sessions, and progress tracking.
+ *
+ * @module server/types
+ */
+import type { ServerResponse } from 'node:http';
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export { VERSION } from '../version.js';
+/**
+ * SSE Event types for streaming responses
+ */
+export declare enum SSEEventType {
+    PROGRESS = "progress",
+    RESULT = "result",
+    ERROR = "error",
+    CONNECTED = "connected",
+    KEEPALIVE = "keepalive"
+}
+/**
+ * Server configuration interface
+ * @interface ServerConfig
+ */
+export interface ServerConfig {
+    /** Primary model for KemdiCode AI */
+    primaryModel: string;
+    /** Fallback model when quota exceeded */
+    fallbackModel?: string;
+    /** API base URL for KemdiCode AI */
+    apiBaseUrl?: string;
+    /** API key for KemdiCode AI */
+    apiKey?: string;
+}
+/**
+ * Session configuration interface
+ * @interface SessionConfig
+ */
+export interface SessionConfig {
+    /** Unique session identifier */
+    sessionId: string;
+    /** Current working directory for this session */
+    cwd: string;
+    /** Model override for this session */
+    model?: string;
+    /** Project type (auto-detected) */
+    projectType?: string;
+}
+/**
+ * Per-request progress state for tracking concurrent operations
+ * @interface ProgressState
+ */
+export interface ProgressState {
+    /** Whether operation is currently processing */
+    isProcessing: boolean;
+    /** Name of the operation */
+    operation: string;
+    /** Latest output for progress display */
+    latestOutput: string;
+    /** SSE response for streaming (if applicable) */
+    sseResponse?: ServerResponse;
+}
+/**
+ * Progress tracking data returned by startProgress
+ * @interface ProgressData
+ */
+export interface ProgressData {
+    interval: NodeJS.Timeout;
+    token?: string | number;
+    requestId: string | number;
+    mcpServer?: Server;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGxE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/server/types.js

@@ -0,0 +1,25 @@
+/**
+ * KemdiCode MCP Server - Server Types
+ * 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.
+ */
+// Re-export VERSION from central version file
+export { VERSION } from '../version.js';
+/**
+ * SSE Event types for streaming responses
+ */
+export var SSEEventType;
+(function (SSEEventType) {
+    SSEEventType["PROGRESS"] = "progress";
+    SSEEventType["RESULT"] = "result";
+    SSEEventType["ERROR"] = "error";
+    SSEEventType["CONNECTED"] = "connected";
+    SSEEventType["KEEPALIVE"] = "keepalive";
+})(SSEEventType || (SSEEventType = {}));
+// ToolArguments type is re-exported from tools/registry.js
+// Use: import type { ToolArguments } from '../tools/registry.js';
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,8CAA8C;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,uCAAuB,CAAA;IACvB,uCAAuB,CAAA;AACzB,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AA0DD,2DAA2D;AAC3D,kEAAkE"}

package/dist/session/cwd-resolver.d.ts

@@ -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/>.
+ */
+import { CwdResolutionResult, ProjectType, ProjectInfo } from './types.js';
+/**
+ * Options for CWD resolution
+ *
+ * @interface CwdResolutionOptions
+ * @description Configuration options passed to resolveCwd function
+ */
+export interface CwdResolutionOptions {
+    /** X-Project-Path header value from HTTP request */
+    headerPath?: string;
+    /** cwd parameter from tool request body */
+    parameterCwd?: string;
+    /** Explicitly set CWD (used when creating sessions) */
+    explicitCwd?: string;
+}
+/**
+ * Detect project type from directory (cached)
+ *
+ * @description Identifies the project type by checking for marker files (package.json,
+ *              Cargo.toml, etc). Uses parallel checks and caching for performance.
+ * @param {string} dir - Directory to analyze
+ * @returns {Promise<ProjectType>} Detected project type ('node', 'php', 'rust', etc.) or 'unknown'
+ * @example
+ * ```typescript
+ * const type = await detectProjectType('/path/to/project');
+ * // Returns: 'node', 'php', 'python', 'rust', 'go', 'ruby', 'java', 'dotnet', or 'unknown'
+ * ```
+ */
+export declare function detectProjectType(dir: string): Promise<ProjectType>;
+/**
+ * Detect detailed project information
+ *
+ * @description Performs comprehensive project analysis including type, name, version,
+ *              framework, package manager, and monorepo detection. Reads config files
+ *              (package.json, Cargo.toml, etc.) to extract metadata.
+ * @param {string} dir - Directory to analyze
+ * @returns {Promise<ProjectInfo>} Detailed project information object
+ * @example
+ * ```typescript
+ * const info = await detectProjectInfo('/path/to/project');
+ * // Returns: { type: 'node', name: 'my-app', version: '1.0.0',
+ * //            framework: 'nextjs', packageManager: 'pnpm', isMonorepo: false }
+ * ```
+ */
+export declare function detectProjectInfo(dir: string): Promise<ProjectInfo>;
+/**
+ * Resolve CWD using priority order
+ *
+ * @description Determines the working directory using a priority-based fallback system.
+ *              Also detects project type and git information for the resolved directory.
+ *
+ * Priority order:
+ * 1. X-Project-Path header (from HTTP request)
+ * 2. cwd parameter in request body
+ * 3. explicitCwd option (programmatic override)
+ * 4. KEMDICODE_PROJECT_PATH environment variable
+ * 5. Auto-detect git root from process.cwd()
+ * 6. process.cwd() fallback
+ *
+ * @param {CwdResolutionOptions} [options] - Resolution options
+ * @returns {Promise<CwdResolutionResult>} Resolution result with cwd, source, and project info
+ * @example
+ * ```typescript
+ * const result = await resolveCwd({ headerPath: '/path/from/header' });
+ * // Returns: { cwd: '/path/from/header', source: 'header',
+ * //            isGitRepo: true, projectType: 'node', projectName: 'my-app' }
+ * ```
+ */
+export declare function resolveCwd(options?: CwdResolutionOptions): Promise<CwdResolutionResult>;
+/**
+ * Find project root by walking up the directory tree
+ *
+ * @description Walks up the directory tree from startDir looking for project markers
+ *              or git repository root. Stops at filesystem root if nothing found.
+ * @param {string} startDir - Directory to start searching from
+ * @returns {Promise<string | null>} Project root path or null if not found
+ * @example
+ * ```typescript
+ * const root = await findProjectRoot('/path/to/project/src/deep/folder');
+ * // Returns: '/path/to/project' (where package.json exists)
+ * ```
+ */
+export declare function findProjectRoot(startDir: string): Promise<string | null>;
+/**
+ * Get package manager command for a project type
+ *
+ * @description Maps the detected package manager to its CLI command name.
+ *              Handles special cases like bundler -> bundle, maven -> mvn.
+ * @param {ProjectInfo} projectInfo - Project information with packageManager field
+ * @returns {string | null} Package manager command or null if unknown
+ * @example
+ * ```typescript
+ * const cmd = getPackageManagerCommand({ type: 'node', packageManager: 'pnpm' });
+ * // Returns: 'pnpm'
+ *
+ * const cmd2 = getPackageManagerCommand({ type: 'ruby', packageManager: 'bundler' });
+ * // Returns: 'bundle'
+ * ```
+ */
+export declare function getPackageManagerCommand(projectInfo: ProjectInfo): string | null;
+/**
+ * Get test command for a project
+ *
+ * @description Returns the appropriate test command based on framework first,
+ *              then falls back to package manager test command. Framework-specific
+ *              commands take priority (e.g., 'php artisan test' for Laravel).
+ * @param {ProjectInfo} projectInfo - Project information with framework and packageManager
+ * @returns {string | null} Test command string or null if unknown
+ * @example
+ * ```typescript
+ * const cmd = getTestCommand({ type: 'php', framework: 'laravel' });
+ * // Returns: 'php artisan test'
+ *
+ * const cmd2 = getTestCommand({ type: 'node', packageManager: 'pnpm' });
+ * // Returns: 'pnpm test'
+ * ```
+ */
+export declare function getTestCommand(projectInfo: ProjectInfo): string | null;
+//# sourceMappingURL=cwd-resolver.d.ts.map

package/dist/session/cwd-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd-resolver.d.ts","sourceRoot":"","sources":["../../src/session/cwd-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH,OAAO,EAAE,mBAAmB,EAAa,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA6DzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAuLzE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqDjG;AAoBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoB9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CA+BhF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CA6CtE"}