@compass-ai/nova 1.0.72 → 1.0.74

package/dist/services/log-interpreter.js

@@ -0,0 +1,520 @@
+/**
+ * Log interpretation service for analyzing process output and detecting issues.
+ *
+ * This service analyzes stdout/stderr from command executions, build processes,
+ * and test runs to detect errors, warnings, and other issues. It can suggest
+ * fixes and provide structured error information.
+ */
+import { logger } from '../utils/logger.js';
+import { getEventEmitter } from '../core/event-emitter.js';
+/**
+ * Severity level of a detected issue
+ */
+export var IssueSeverity;
+(function (IssueSeverity) {
+    IssueSeverity["ERROR"] = "error";
+    IssueSeverity["WARNING"] = "warning";
+    IssueSeverity["INFO"] = "info";
+    IssueSeverity["TRACE"] = "trace";
+})(IssueSeverity || (IssueSeverity = {}));
+/**
+ * Category of issue detected
+ */
+export var IssueCategory;
+(function (IssueCategory) {
+    IssueCategory["SYNTAX_ERROR"] = "syntax_error";
+    IssueCategory["TYPE_ERROR"] = "type_error";
+    IssueCategory["RUNTIME_ERROR"] = "runtime_error";
+    IssueCategory["BUILD_ERROR"] = "build_error";
+    IssueCategory["TEST_FAILURE"] = "test_failure";
+    IssueCategory["LINT_ERROR"] = "lint_error";
+    IssueCategory["DEPENDENCY_ERROR"] = "dependency_error";
+    IssueCategory["NETWORK_ERROR"] = "network_error";
+    IssueCategory["PERMISSION_ERROR"] = "permission_error";
+    IssueCategory["FILE_NOT_FOUND"] = "file_not_found";
+    IssueCategory["TIMEOUT"] = "timeout";
+    IssueCategory["OUT_OF_MEMORY"] = "out_of_memory";
+    IssueCategory["UNKNOWN"] = "unknown";
+})(IssueCategory || (IssueCategory = {}));
+/**
+ * LogInterpreter class analyzes command output to detect and categorize issues.
+ *
+ * Features:
+ * - Pattern-based error detection
+ * - Multi-language support (TypeScript, JavaScript, Python, etc.)
+ * - Structured error extraction with file/line information
+ * - Suggestion generation for common errors
+ * - Event emission for real-time issue detection
+ */
+class LogInterpreter {
+    errorPatterns = [];
+    constructor() {
+        this.initializePatterns();
+    }
+    /**
+     * Initializes error detection patterns for various languages and tools.
+     */
+    initializePatterns() {
+        // TypeScript/JavaScript errors
+        this.errorPatterns.push({
+            pattern: /^(.+?)\((\d+),(\d+)\): error TS(\d+): (.+)$/m,
+            category: IssueCategory.TYPE_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                filePath: match[1],
+                line: parseInt(match[2], 10),
+                column: parseInt(match[3], 10),
+                message: `TS${match[4]}: ${match[5]}`,
+            }),
+        }, {
+            pattern: /SyntaxError: (.+)/,
+            category: IssueCategory.SYNTAX_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Syntax Error: ${match[1]}`,
+            }),
+        }, {
+            pattern: /TypeError: (.+)/,
+            category: IssueCategory.TYPE_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Type Error: ${match[1]}`,
+            }),
+        }, {
+            pattern: /ReferenceError: (.+)/,
+            category: IssueCategory.RUNTIME_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Reference Error: ${match[1]}`,
+            }),
+        });
+        // Python errors
+        this.errorPatterns.push({
+            pattern: /File "(.+?)", line (\d+)/,
+            category: IssueCategory.RUNTIME_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                filePath: match[1],
+                line: parseInt(match[2], 10),
+            }),
+        }, {
+            pattern: /(\w+Error): (.+)/,
+            category: IssueCategory.RUNTIME_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `${match[1]}: ${match[2]}`,
+            }),
+        });
+        // Build errors
+        this.errorPatterns.push({
+            pattern: /ERROR in (.+)/,
+            category: IssueCategory.BUILD_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: match[1],
+            }),
+        }, {
+            pattern: /Build failed with (\d+) error/i,
+            category: IssueCategory.BUILD_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Build failed with ${match[1]} error(s)`,
+            }),
+        });
+        // Test failures
+        this.errorPatterns.push({
+            pattern: /FAIL (.+)/,
+            category: IssueCategory.TEST_FAILURE,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Test failed: ${match[1]}`,
+            }),
+        }, {
+            pattern: /(\d+) failing/,
+            category: IssueCategory.TEST_FAILURE,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `${match[1]} test(s) failing`,
+            }),
+        });
+        // Dependency errors
+        this.errorPatterns.push({
+            pattern: /Cannot find module ['"](.+?)['"]/,
+            category: IssueCategory.DEPENDENCY_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Cannot find module: ${match[1]}`,
+                suggestions: [
+                    `Run 'npm install ${match[1]}' to install the missing package`,
+                    `Check if '${match[1]}' is listed in package.json dependencies`,
+                ],
+            }),
+        }, {
+            pattern: /Module not found: Error: Can't resolve ['"](.+?)['"]/,
+            category: IssueCategory.DEPENDENCY_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Cannot resolve module: ${match[1]}`,
+                suggestions: [`Install the missing dependency: ${match[1]}`],
+            }),
+        }, {
+            pattern: /npm ERR! code E(\w+)/,
+            category: IssueCategory.DEPENDENCY_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `npm error: E${match[1]}`,
+            }),
+        });
+        // File system errors
+        this.errorPatterns.push({
+            pattern: /ENOENT: no such file or directory.*'(.+?)'/,
+            category: IssueCategory.FILE_NOT_FOUND,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `File not found: ${match[1]}`,
+                filePath: match[1],
+            }),
+        }, {
+            pattern: /EACCES: permission denied.*'(.+?)'/,
+            category: IssueCategory.PERMISSION_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (match) => ({
+                message: `Permission denied: ${match[1]}`,
+                filePath: match[1],
+                suggestions: [`Check file permissions for: ${match[1]}`],
+            }),
+        });
+        // Network errors
+        this.errorPatterns.push({
+            pattern: /ETIMEDOUT|ECONNREFUSED|ENOTFOUND/,
+            category: IssueCategory.NETWORK_ERROR,
+            severity: IssueSeverity.ERROR,
+            extract: (_match) => ({
+                message: 'Network error - connection failed',
+                suggestions: ['Check internet connection', 'Verify the service is running'],
+            }),
+        });
+        // Timeout errors
+        this.errorPatterns.push({
+            pattern: /timeout|timed out/i,
+            category: IssueCategory.TIMEOUT,
+            severity: IssueSeverity.ERROR,
+            extract: (_match) => ({
+                message: 'Operation timed out',
+                suggestions: ['Increase timeout duration', 'Check for performance issues'],
+            }),
+        });
+        // Memory errors
+        this.errorPatterns.push({
+            pattern: /out of memory|heap out of memory/i,
+            category: IssueCategory.OUT_OF_MEMORY,
+            severity: IssueSeverity.ERROR,
+            extract: (_match) => ({
+                message: 'Out of memory error',
+                suggestions: [
+                    'Increase Node.js heap size with --max-old-space-size',
+                    'Check for memory leaks',
+                    'Optimize data processing',
+                ],
+            }),
+        });
+        // Warnings
+        this.errorPatterns.push({
+            pattern: /WARNING: (.+)/,
+            category: IssueCategory.UNKNOWN,
+            severity: IssueSeverity.WARNING,
+            extract: (match) => ({
+                message: match[1],
+            }),
+        }, {
+            pattern: /DeprecationWarning: (.+)/,
+            category: IssueCategory.UNKNOWN,
+            severity: IssueSeverity.WARNING,
+            extract: (match) => ({
+                message: `Deprecation: ${match[1]}`,
+            }),
+        });
+    }
+    /**
+     * Interprets log output and detects issues.
+     *
+     * @param stdout - Standard output from command
+     * @param stderr - Standard error output from command
+     * @param exitCode - Exit code of the command
+     * @returns Log interpretation result
+     *
+     * @example
+     * ```typescript
+     * const interpreter = getLogInterpreter();
+     * const result = interpreter.interpret(stdout, stderr, 1);
+     * console.log(`Found ${result.issues.length} issues`);
+     * result.issues.forEach(issue => {
+     *   console.log(`${issue.severity}: ${issue.message}`);
+     * });
+     * ```
+     */
+    interpret(stdout, stderr, exitCode) {
+        const combinedOutput = `${stdout}\n${stderr}`;
+        const issues = [];
+        // Detect issues using patterns
+        for (const pattern of this.errorPatterns) {
+            const matches = combinedOutput.matchAll(new RegExp(pattern.pattern, 'gm'));
+            for (const matchArray of matches) {
+                const match = matchArray;
+                const extracted = pattern.extract ? pattern.extract(match) : {};
+                const issue = {
+                    severity: pattern.severity,
+                    category: pattern.category,
+                    message: extracted.message || match[0],
+                    rawError: match[0],
+                    filePath: extracted.filePath,
+                    line: extracted.line,
+                    column: extracted.column,
+                    suggestions: extracted.suggestions,
+                    context: extracted.context,
+                };
+                // Try to extract stack trace
+                const stackMatch = combinedOutput.match(new RegExp(`${this.escapeRegex(match[0])}([\\s\\S]{0,500})`, 'm'));
+                if (stackMatch) {
+                    const stackLines = stackMatch[1]
+                        .split('\n')
+                        .slice(0, 10)
+                        .filter((line) => line.trim().startsWith('at '))
+                        .map((line) => line.trim());
+                    if (stackLines.length > 0) {
+                        issue.stackTrace = stackLines;
+                    }
+                }
+                issues.push(issue);
+                // Emit event for real-time issue detection
+                const eventEmitter = getEventEmitter();
+                eventEmitter.emit('issue-detected', { issue });
+            }
+        }
+        // Remove duplicate issues
+        const uniqueIssues = this.deduplicateIssues(issues);
+        // Calculate error counts
+        const errorCounts = {
+            errors: uniqueIssues.filter((i) => i.severity === IssueSeverity.ERROR)
+                .length,
+            warnings: uniqueIssues.filter((i) => i.severity === IssueSeverity.WARNING)
+                .length,
+            info: uniqueIssues.filter((i) => i.severity === IssueSeverity.INFO).length,
+        };
+        // Determine success
+        const success = exitCode === 0 && errorCounts.errors === 0;
+        // Find most critical issue
+        const criticalIssue = uniqueIssues.find((i) => i.severity === IssueSeverity.ERROR);
+        // Generate summary
+        const summary = this.generateSummary(success, errorCounts, uniqueIssues, exitCode);
+        // Check if completed
+        const completed = combinedOutput.includes('Done') ||
+            combinedOutput.includes('Finished') ||
+            combinedOutput.includes('Successfully') ||
+            (exitCode === 0 && !combinedOutput.toLowerCase().includes('error'));
+        const result = {
+            success,
+            issues: uniqueIssues,
+            summary,
+            errorCounts,
+            criticalIssue,
+            completed,
+        };
+        logger.debug(`Log interpretation complete: ${summary}`);
+        // Emit event
+        const eventEmitter = getEventEmitter();
+        eventEmitter.emit('log-interpreted', { result });
+        return result;
+    }
+    /**
+     * Deduplicates issues based on message and location.
+     *
+     * @param issues - Array of detected issues
+     * @returns Deduplicated array
+     */
+    deduplicateIssues(issues) {
+        const seen = new Set();
+        const unique = [];
+        for (const issue of issues) {
+            const key = `${issue.message}-${issue.filePath || ''}-${issue.line || 0}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                unique.push(issue);
+            }
+        }
+        return unique;
+    }
+    /**
+     * Generates a summary of the log analysis.
+     *
+     * @param success - Whether execution was successful
+     * @param errorCounts - Error counts by severity
+     * @param issues - All detected issues
+     * @param exitCode - Exit code
+     * @returns Summary string
+     */
+    generateSummary(success, errorCounts, issues, exitCode) {
+        if (success) {
+            if (errorCounts.warnings > 0) {
+                return `Completed with ${errorCounts.warnings} warning(s)`;
+            }
+            return 'Completed successfully';
+        }
+        const parts = [];
+        if (exitCode !== 0) {
+            parts.push(`Exit code: ${exitCode}`);
+        }
+        if (errorCounts.errors > 0) {
+            parts.push(`${errorCounts.errors} error(s)`);
+        }
+        if (errorCounts.warnings > 0) {
+            parts.push(`${errorCounts.warnings} warning(s)`);
+        }
+        if (issues.length > 0 && issues[0].category !== IssueCategory.UNKNOWN) {
+            parts.push(`Primary issue: ${issues[0].category.replace(/_/g, ' ')}`);
+        }
+        return parts.length > 0 ? parts.join(', ') : 'Execution failed';
+    }
+    /**
+     * Escapes special regex characters in a string.
+     *
+     * @param str - String to escape
+     * @returns Escaped string
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Analyzes build output specifically.
+     *
+     * @param output - Build output
+     * @param exitCode - Exit code
+     * @returns Interpretation result
+     */
+    interpretBuildOutput(output, exitCode) {
+        return this.interpret(output, '', exitCode);
+    }
+    /**
+     * Analyzes test output specifically.
+     *
+     * @param output - Test output
+     * @param exitCode - Exit code
+     * @returns Interpretation result with test-specific insights
+     */
+    interpretTestOutput(output, exitCode) {
+        const result = this.interpret(output, '', exitCode);
+        // Extract test statistics
+        const passMatch = output.match(/(\d+) passing/);
+        const failMatch = output.match(/(\d+) failing/);
+        const skipMatch = output.match(/(\d+) pending/);
+        if (passMatch || failMatch || skipMatch) {
+            result.testStats = {
+                passing: passMatch ? parseInt(passMatch[1], 10) : 0,
+                failing: failMatch ? parseInt(failMatch[1], 10) : 0,
+                skipped: skipMatch ? parseInt(skipMatch[1], 10) : 0,
+            };
+        }
+        return result;
+    }
+    /**
+     * Gets suggestions for a specific issue category.
+     *
+     * @param category - Issue category
+     * @returns Array of suggestion strings
+     */
+    getSuggestionsForCategory(category) {
+        const suggestions = {
+            [IssueCategory.SYNTAX_ERROR]: [
+                'Check for missing brackets, parentheses, or semicolons',
+                'Verify proper use of quotes',
+                'Look for unclosed blocks',
+            ],
+            [IssueCategory.TYPE_ERROR]: [
+                'Check variable types and function signatures',
+                'Verify TypeScript configuration',
+                'Add type annotations where needed',
+            ],
+            [IssueCategory.BUILD_ERROR]: [
+                'Clean build artifacts and rebuild',
+                'Check build configuration',
+                'Verify all dependencies are installed',
+            ],
+            [IssueCategory.TEST_FAILURE]: [
+                'Review test expectations',
+                'Check for async timing issues',
+                'Verify test data and fixtures',
+            ],
+            [IssueCategory.DEPENDENCY_ERROR]: [
+                'Run dependency installation command',
+                'Clear package manager cache',
+                'Check dependency versions',
+            ],
+            [IssueCategory.NETWORK_ERROR]: [
+                'Check internet connection',
+                'Verify service URLs',
+                'Check firewall settings',
+            ],
+            [IssueCategory.FILE_NOT_FOUND]: [
+                'Verify file path is correct',
+                'Check working directory',
+                'Ensure file exists in the project',
+            ],
+            [IssueCategory.PERMISSION_ERROR]: [
+                'Check file permissions',
+                'Run with appropriate privileges',
+                'Verify ownership',
+            ],
+            [IssueCategory.TIMEOUT]: [
+                'Increase timeout duration',
+                'Check for infinite loops',
+                'Optimize performance',
+            ],
+            [IssueCategory.OUT_OF_MEMORY]: [
+                'Increase memory limit',
+                'Check for memory leaks',
+                'Optimize data structures',
+            ],
+            [IssueCategory.RUNTIME_ERROR]: [
+                'Review stack trace',
+                'Check for null/undefined values',
+                'Add error handling',
+            ],
+            [IssueCategory.LINT_ERROR]: [
+                'Run linter with --fix flag',
+                'Review linter configuration',
+                'Format code according to style guide',
+            ],
+            [IssueCategory.UNKNOWN]: ['Review error message', 'Check documentation'],
+        };
+        return suggestions[category] || [];
+    }
+}
+// Singleton instance
+let logInterpreterInstance = null;
+/**
+ * Gets the singleton LogInterpreter instance.
+ *
+ * @returns The LogInterpreter instance
+ *
+ * @example
+ * ```typescript
+ * const interpreter = getLogInterpreter();
+ * const result = interpreter.interpret(stdout, stderr, exitCode);
+ * ```
+ */
+export function getLogInterpreter() {
+    if (!logInterpreterInstance) {
+        logInterpreterInstance = new LogInterpreter();
+    }
+    return logInterpreterInstance;
+}
+/**
+ * Creates a new LogInterpreter instance.
+ *
+ * @returns A new LogInterpreter instance
+ */
+export function createLogInterpreter() {
+    return new LogInterpreter();
+}
+export { LogInterpreter };
+//# sourceMappingURL=log-interpreter.js.map

package/dist/services/log-interpreter.js.map

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

package/dist/services/mcp-config-manager.d.ts

@@ -0,0 +1,141 @@
+/**
+ * MCP Configuration Manager Service.
+ *
+ * This service manages MCP server configurations across three scopes:
+ * - Local: Private to user in current project (~/.compass.json under project paths)
+ * - Project: Shared via .mcp.json file at project root
+ * - User: Available across all projects (~/.compass.json)
+ *
+ * Features:
+ * - Configuration loading from all scopes with precedence handling
+ * - Environment variable expansion (${VAR} and ${VAR:-default} syntax)
+ * - Project approval tracking for .mcp.json servers
+ * - Plugin MCP server support
+ */
+import { MCPServerConfig, MCPScope, MCPAddServerOptions, MCPOperationResult, MCPPluginServerConfig, MCPEnvVarRef } from '../types/mcp.js';
+/**
+ * MCP Configuration Manager class.
+ */
+declare class MCPConfigManager {
+    private userConfig;
+    private projectConfigs;
+    private pluginConfigs;
+    private configPath;
+    private loaded;
+    private loadedProjectRoot;
+    constructor();
+    /**
+     * Loads all MCP configurations.
+     */
+    load(projectRoot?: string): Promise<void>;
+    /**
+     * Loads user-scoped configuration from ~/.compass/config.json
+     */
+    private loadUserConfig;
+    /**
+     * Loads project-scoped configuration from .mcp.json
+     */
+    private loadProjectConfig;
+    /**
+     * Saves user-scoped configuration to ~/.compass/config.json
+     */
+    private saveUserConfig;
+    /**
+     * Saves project-scoped configuration to .mcp.json
+     */
+    private saveProjectConfig;
+    /**
+     * Adds a new MCP server configuration.
+     */
+    addServer(options: MCPAddServerOptions, projectRoot?: string): Promise<MCPOperationResult>;
+    /**
+     * Creates a server configuration from add options.
+     */
+    private createServerConfig;
+    /**
+     * Adds a server to user scope.
+     */
+    private addUserScopedServer;
+    /**
+     * Adds a server to project scope.
+     */
+    private addProjectScopedServer;
+    /**
+     * Adds a server to local scope.
+     */
+    private addLocalScopedServer;
+    /**
+     * Removes an MCP server configuration.
+     */
+    removeServer(name: string, projectRoot?: string): Promise<MCPOperationResult>;
+    /**
+     * Gets a specific MCP server configuration.
+     */
+    getServer(name: string, projectRoot?: string): MCPServerConfig | undefined;
+    /**
+     * Gets all MCP server configurations for the given context.
+     */
+    getAllServers(projectRoot?: string): MCPServerConfig[];
+    /**
+     * Adds server configuration from JSON string.
+     */
+    addServerFromJson(name: string, jsonConfig: string, scope?: MCPScope, projectRoot?: string): Promise<MCPOperationResult>;
+    /**
+     * Registers plugin-provided MCP servers.
+     */
+    registerPluginServers(pluginConfig: MCPPluginServerConfig): void;
+    /**
+     * Unregisters plugin-provided MCP servers.
+     */
+    unregisterPluginServers(pluginName: string): void;
+    /**
+     * Checks if a project is fully trusted (all servers auto-approved).
+     */
+    isProjectTrusted(projectRoot: string): boolean;
+    /**
+     * Marks a project as trusted (all current and future servers auto-approved).
+     */
+    setProjectTrusted(projectRoot: string): Promise<void>;
+    /**
+     * Checks if a project server has been approved.
+     */
+    isProjectServerApproved(projectRoot: string, serverName: string): boolean;
+    /**
+     * Records a project server approval decision.
+     */
+    setProjectServerApproval(projectRoot: string, serverName: string, approved: boolean, configHash?: string): Promise<void>;
+    /**
+     * Resets all project approval choices.
+     */
+    resetProjectApprovals(): Promise<void>;
+    /**
+     * Generates a hash of server configuration for change detection.
+     */
+    generateConfigHash(config: MCPServerConfig): string;
+    /**
+     * Expands environment variables in a configuration.
+     */
+    private expandEnvVars;
+    /**
+     * Expands environment variables in plugin configuration, including COMPASS_PLUGIN_ROOT.
+     */
+    private expandPluginEnvVars;
+    /**
+     * Parses environment variable reference from string.
+     */
+    parseEnvVarRef(str: string): MCPEnvVarRef | null;
+    /**
+     * Gets servers that need project approval.
+     */
+    getUnapprovedProjectServers(projectRoot: string): MCPServerConfig[];
+}
+/**
+ * Gets the singleton MCPConfigManager instance.
+ */
+export declare function getMCPConfigManager(): MCPConfigManager;
+/**
+ * Creates a new MCPConfigManager instance.
+ */
+export declare function createMCPConfigManager(): MCPConfigManager;
+export { MCPConfigManager };
+//# sourceMappingURL=mcp-config-manager.d.ts.map