@codemcp/workflows-core 3.1.16

package/dist/interaction-logger.js

@@ -0,0 +1,87 @@
+/**
+ * Interaction Logger module
+ *
+ * Handles logging of tool interactions to the database for auditing and debugging.
+ */
+import { createLogger } from './logger.js';
+const logger = createLogger('InteractionLogger');
+/**
+ * Handles logging of tool interactions to the database
+ */
+export class InteractionLogger {
+    database;
+    /**
+     * Create a new InteractionLogger
+     *
+     * @param database - Database instance to use for logging
+     */
+    constructor(database) {
+        this.database = database;
+        logger.debug('InteractionLogger initialized');
+    }
+    /**
+     * Log an interaction with a tool
+     *
+     * @param conversationId - ID of the conversation
+     * @param toolName - Name of the tool that was called
+     * @param inputParams - Input parameters to the tool (will be stringified)
+     * @param responseData - Response data from the tool (will be stringified)
+     * @param currentPhase - Current development phase
+     * @returns Promise that resolves when the log is saved
+     */
+    async logInteraction(conversationId, toolName, inputParams, responseData, currentPhase) {
+        logger.debug('Logging interaction', {
+            conversationId,
+            toolName,
+            currentPhase,
+        });
+        try {
+            const timestamp = new Date().toISOString();
+            const log = {
+                conversationId,
+                toolName,
+                inputParams: JSON.stringify(inputParams),
+                responseData: JSON.stringify(responseData),
+                currentPhase,
+                timestamp,
+            };
+            await this.database.logInteraction(log);
+            logger.info('Interaction logged successfully', {
+                conversationId,
+                toolName,
+                timestamp,
+            });
+        }
+        catch (error) {
+            logger.error('Failed to log interaction', error, {
+                conversationId,
+                toolName,
+            });
+            // Don't throw the error - logging should not break the main flow
+        }
+    }
+    /**
+     * Get all interactions for a specific conversation
+     *
+     * @param conversationId - ID of the conversation to get logs for
+     * @returns Promise that resolves to an array of interaction logs
+     */
+    async getInteractionsByConversationId(conversationId) {
+        logger.debug('Getting interactions by conversation ID', { conversationId });
+        try {
+            const logs = await this.database.getInteractionsByConversationId(conversationId);
+            logger.info('Retrieved interaction logs', {
+                conversationId,
+                count: logs.length,
+            });
+            return logs;
+        }
+        catch (error) {
+            logger.error('Failed to get interaction logs', error, {
+                conversationId,
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=interaction-logger.js.map

package/dist/interaction-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-logger.js","sourceRoot":"","sources":["../src/interaction-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAAW;IAE3B;;;;OAIG;IACH,YAAY,QAAkB;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,QAAgB,EAChB,WAAoB,EACpB,YAAqB,EACrB,YAAoB;QAEpB,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;YAClC,cAAc;YACd,QAAQ;YACR,YAAY;SACb,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAE3C,MAAM,GAAG,GAAmB;gBAC1B,cAAc;gBACd,QAAQ;gBACR,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;gBACxC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC1C,YAAY;gBACZ,SAAS;aACV,CAAC;YAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAC7C,cAAc;gBACd,QAAQ;gBACR,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAc,EAAE;gBACxD,cAAc;gBACd,QAAQ;aACT,CAAC,CAAC;YACH,iEAAiE;QACnE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,+BAA+B,CACnC,cAAsB;QAEtB,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAE5E,IAAI,CAAC;YACH,MAAM,IAAI,GACR,MAAM,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,cAAc,CAAC,CAAC;YAEtE,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;gBACxC,cAAc;gBACd,KAAK,EAAE,IAAI,CAAC,MAAM;aACnB,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAc,EAAE;gBAC7D,cAAc;aACf,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Logging utility for Vibe Feature MCP Server
+ *
+ * Provides structured logging with proper MCP compliance:
+ * - Uses stderr for all local logging (MCP requirement)
+ * - Supports MCP log message notifications to client
+ * - Provides structured logging with proper levels:
+ *   - debug: Tracing and detailed execution flow
+ *   - info: Success operations and important milestones
+ *   - warn: Expected errors and recoverable issues
+ *   - error: Caught but unexpected errors
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+export interface LogContext {
+    component?: string;
+    conversationId?: string;
+    phase?: string;
+    operation?: string;
+    [key: string]: unknown;
+}
+/**
+ * Set the MCP server instance for log notifications
+ */
+export declare function setMcpServerForLogging(server: McpServer): void;
+/**
+ * Set the logging level from MCP client request
+ */
+export declare function setMcpLoggingLevel(level: string): void;
+declare class Logger {
+    private component;
+    private explicitLogLevel?;
+    constructor(component: string, logLevel?: LogLevel);
+    private getCurrentLogLevel;
+    private getLogLevelFromEnv;
+    private shouldLog;
+    private formatMessage;
+    /**
+     * Send log message to MCP client if server is available and level is appropriate
+     */
+    private sendMcpLogMessage;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    /**
+     * Send enhanced MCP notifications with better formatting for important events
+     */
+    private sendEnhancedMcpNotification;
+    /**
+     * Capitalize phase name for display
+     */
+    private capitalizePhase;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+    child(childComponent: string): Logger;
+}
+export declare function createLogger(component: string, logLevel?: LogLevel): Logger;
+export declare const logger: Logger;
+export {};

package/dist/logger.js

@@ -0,0 +1,283 @@
+/**
+ * Logging utility for Vibe Feature MCP Server
+ *
+ * Provides structured logging with proper MCP compliance:
+ * - Uses stderr for all local logging (MCP requirement)
+ * - Supports MCP log message notifications to client
+ * - Provides structured logging with proper levels:
+ *   - debug: Tracing and detailed execution flow
+ *   - info: Success operations and important milestones
+ *   - warn: Expected errors and recoverable issues
+ *   - error: Caught but unexpected errors
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+// Global MCP server reference for log notifications
+let mcpServerInstance = null;
+// Unified logging level - can be set by MCP client or environment
+let currentLoggingLevel = null;
+// Test mode detection function to check at runtime
+function isTestMode() {
+    // Check explicit environment variables
+    if (process.env.NODE_ENV === 'test' || process.env.VITEST === 'true') {
+        return true;
+    }
+    // Check if running in a temporary directory (common for tests)
+    const cwd = process.cwd();
+    if (cwd.includes('/tmp/') || cwd.includes('temp') || cwd.includes('test-')) {
+        return true;
+    }
+    // Check if LOG_LEVEL is explicitly set to ERROR
+    if (process.env.LOG_LEVEL === 'ERROR') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Set the MCP server instance for log notifications
+ */
+export function setMcpServerForLogging(server) {
+    mcpServerInstance = server;
+}
+/**
+ * Set the logging level from MCP client request
+ */
+export function setMcpLoggingLevel(level) {
+    // Map MCP levels to our internal levels
+    const levelMap = {
+        debug: LogLevel.DEBUG,
+        info: LogLevel.INFO,
+        notice: LogLevel.INFO,
+        warning: LogLevel.WARN,
+        error: LogLevel.ERROR,
+        critical: LogLevel.ERROR,
+        alert: LogLevel.ERROR,
+        emergency: LogLevel.ERROR,
+    };
+    currentLoggingLevel = levelMap[level] ?? LogLevel.INFO;
+}
+class Logger {
+    component;
+    explicitLogLevel;
+    constructor(component, logLevel) {
+        this.component = component;
+        this.explicitLogLevel = logLevel;
+    }
+    getCurrentLogLevel() {
+        // Check environment variable first (allows SILENT to override test mode)
+        const envLevel = this.getLogLevelFromEnv();
+        if (envLevel === LogLevel.SILENT) {
+            return LogLevel.SILENT;
+        }
+        // Force ERROR level in test environments (unless SILENT)
+        if (isTestMode()) {
+            return LogLevel.ERROR;
+        }
+        // Use MCP-set level if available (takes precedence)
+        if (currentLoggingLevel !== null) {
+            return currentLoggingLevel;
+        }
+        // Use environment variable level
+        if (envLevel !== null) {
+            return envLevel;
+        }
+        // If explicit log level was provided, use it
+        if (this.explicitLogLevel !== undefined) {
+            return this.explicitLogLevel;
+        }
+        // Default to INFO
+        return LogLevel.INFO;
+    }
+    getLogLevelFromEnv() {
+        const envLevel = process.env.LOG_LEVEL?.toUpperCase();
+        switch (envLevel) {
+            case 'DEBUG':
+                return LogLevel.DEBUG;
+            case 'INFO':
+                return LogLevel.INFO;
+            case 'WARN':
+                return LogLevel.WARN;
+            case 'ERROR':
+                return LogLevel.ERROR;
+            case 'SILENT':
+                return LogLevel.SILENT;
+            default:
+                return null;
+        }
+    }
+    shouldLog(level) {
+        return level >= this.getCurrentLogLevel();
+    }
+    formatMessage(level, message, context) {
+        const timestamp = new Date().toISOString();
+        const contextStr = context ? ` ${JSON.stringify(context)}` : '';
+        return `[${timestamp}] ${level.toUpperCase()} [${this.component}] ${message}${contextStr}`;
+    }
+    /**
+     * Send log message to MCP client if server is available and level is appropriate
+     */
+    async sendMcpLogMessage(level, message, context) {
+        if (mcpServerInstance) {
+            try {
+                // Safely serialize context to avoid JSON issues
+                let logData = message;
+                if (context) {
+                    try {
+                        const contextStr = JSON.stringify(context, null, 0);
+                        logData = `${message} ${contextStr}`;
+                    }
+                    catch (_error) {
+                        // If JSON serialization fails, just use the message
+                        logData = `${message} [context serialization failed]`;
+                    }
+                }
+                await mcpServerInstance.server.notification({
+                    method: 'notifications/message',
+                    params: {
+                        level,
+                        logger: this.component,
+                        data: logData,
+                    },
+                });
+            }
+            catch (error) {
+                // Fallback to stderr if MCP notification fails
+                // Don't use this.error to avoid infinite recursion
+                if (!isTestMode()) {
+                    process.stderr.write(`[MCP-LOG-ERROR] Failed to send log notification: ${error}\n`);
+                }
+            }
+        }
+    }
+    debug(message, context) {
+        if (this.shouldLog(LogLevel.DEBUG)) {
+            const formattedMessage = this.formatMessage('debug', message, context);
+            // Always log to stderr for MCP compliance
+            process.stderr.write(formattedMessage + '\n');
+            // Also send to MCP client if available (only for debug level)
+            this.sendMcpLogMessage('debug', message, context).catch(() => {
+                // Ignore MCP notification errors for debug messages
+            });
+        }
+    }
+    info(message, context) {
+        if (this.shouldLog(LogLevel.INFO)) {
+            const formattedMessage = this.formatMessage('info', message, context);
+            // Always log to stderr for MCP compliance
+            process.stderr.write(formattedMessage + '\n');
+            // Send enhanced notifications for important events
+            this.sendEnhancedMcpNotification('info', message, context).catch(() => {
+                // Ignore MCP notification errors for info messages
+            });
+        }
+    }
+    /**
+     * Send enhanced MCP notifications with better formatting for important events
+     */
+    async sendEnhancedMcpNotification(level, message, context) {
+        if (mcpServerInstance) {
+            try {
+                let enhancedMessage = message;
+                let notificationLevel = level;
+                // Enhance phase transition messages
+                if (context &&
+                    (context.from || context.to) &&
+                    message.includes('transition')) {
+                    const from = context.from
+                        ? this.capitalizePhase(context.from)
+                        : '';
+                    const to = context.to
+                        ? this.capitalizePhase(context.to)
+                        : '';
+                    if (from && to) {
+                        enhancedMessage = `Phase Transition: ${from} → ${to}`;
+                        notificationLevel = 'info';
+                    }
+                }
+                // Enhance initialization messages
+                if (message.includes('initialized successfully')) {
+                    enhancedMessage = '🚀 Vibe Feature MCP Server Ready';
+                    notificationLevel = 'info';
+                }
+                // Safely serialize context to avoid JSON issues
+                let logData = enhancedMessage;
+                if (context) {
+                    try {
+                        const contextStr = JSON.stringify(context, null, 0);
+                        logData = `${enhancedMessage} ${contextStr}`;
+                    }
+                    catch (_error) {
+                        // If JSON serialization fails, just use the message
+                        logData = `${enhancedMessage} [context serialization failed]`;
+                    }
+                }
+                // Use the underlying server's notification method
+                await mcpServerInstance.server.notification({
+                    method: 'notifications/message',
+                    params: {
+                        level: notificationLevel,
+                        logger: this.component,
+                        data: logData,
+                    },
+                });
+            }
+            catch (error) {
+                // Fallback to stderr if MCP notification fails
+                // Don't use this.error to avoid infinite recursion
+                if (!isTestMode()) {
+                    process.stderr.write(`[MCP-LOG-ERROR] Failed to send log notification: ${error}\n`);
+                }
+            }
+        }
+    }
+    /**
+     * Capitalize phase name for display
+     */
+    capitalizePhase(phase) {
+        return phase
+            .split('_')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    warn(message, context) {
+        if (this.shouldLog(LogLevel.WARN)) {
+            const formattedMessage = this.formatMessage('warn', message, context);
+            // Always log to stderr for MCP compliance
+            process.stderr.write(formattedMessage + '\n');
+            // Also send to MCP client if available
+            this.sendEnhancedMcpNotification('warning', message, context).catch(() => {
+                // Ignore MCP notification errors for warn messages
+            });
+        }
+    }
+    error(message, error, context) {
+        if (this.shouldLog(LogLevel.ERROR)) {
+            const errorContext = error
+                ? { ...context, error: error.message, stack: error.stack }
+                : context;
+            const formattedMessage = this.formatMessage('error', message, errorContext);
+            // Always log to stderr for MCP compliance
+            process.stderr.write(formattedMessage + '\n');
+            // Also send to MCP client if available
+            this.sendEnhancedMcpNotification('error', message, errorContext).catch(() => {
+                // Ignore MCP notification errors for error messages
+            });
+        }
+    }
+    child(childComponent) {
+        return new Logger(`${this.component}:${childComponent}`, this.explicitLogLevel);
+    }
+}
+// Factory function to create loggers
+export function createLogger(component, logLevel) {
+    return new Logger(component, logLevel);
+}
+// Default logger for the main application
+export const logger = createLogger('VibeFeatureMCP');
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/path-validation-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Path Validation Utilities
+ *
+ * Provides utilities for validating file paths, resolving relative paths,
+ * and ensuring security constraints for the file linking functionality.
+ */
+export interface PathValidationResult {
+    isValid: boolean;
+    resolvedPath?: string;
+    error?: string;
+}
+export declare class PathValidationUtils {
+    /**
+     * Validate if a string is a known template name
+     */
+    static isTemplateName(value: string, availableTemplates: string[]): boolean;
+    /**
+     * Validate and resolve a file path
+     */
+    static validateFilePath(filePath: string, projectPath: string): Promise<PathValidationResult>;
+    /**
+     * Validate and resolve a file or directory path
+     */
+    static validateFileOrDirectoryPath(filePath: string, projectPath: string): Promise<PathValidationResult>;
+    /**
+     * Resolve a file path to absolute, handling various formats
+     */
+    static resolvePath(filePath: string, projectPath: string): string;
+    /**
+     * Check if a resolved path is within safe boundaries
+     * Prevents directory traversal attacks
+     */
+    static isPathSafe(resolvedPath: string, projectPath: string): boolean;
+    /**
+     * Validate parameter as either template name or file path
+     */
+    static validateParameter(value: string, availableTemplates: string[], projectPath: string): Promise<{
+        isTemplate: boolean;
+        isFilePath: boolean;
+        resolvedPath?: string;
+        error?: string;
+    }>;
+    /**
+     * Get common file patterns for documentation
+     */
+    static getCommonDocumentationPatterns(): {
+        architecture: string[];
+        requirements: string[];
+        design: string[];
+    };
+}