@rbalchii/anchor-engine 4.7.0

package/engine/dist/services/health-check-enhanced.js

@@ -0,0 +1,417 @@
+/**
+ * Enhanced Health Check Service for ECE
+ *
+ * Implements comprehensive health monitoring for all system components
+ * with performance metrics and detailed diagnostics
+ */
+import { db } from '../core/db.js';
+import { nativeModuleManager } from '../utils/native-module-manager.js';
+import * as os from 'os';
+import * as fs from 'fs/promises';
+import { pathManager } from '../utils/path-manager.js';
+import { performanceMonitor } from '../utils/performance-monitor.js';
+export class HealthCheckService {
+    static instance;
+    startTime;
+    constructor() {
+        this.startTime = Date.now();
+    }
+    static getInstance() {
+        if (!HealthCheckService.instance) {
+            HealthCheckService.instance = new HealthCheckService();
+        }
+        return HealthCheckService.instance;
+    }
+    /**
+     * Perform comprehensive health check
+     */
+    async checkHealth() {
+        const components = [];
+        // Check database
+        const dbHealth = await this.checkDatabaseHealth();
+        components.push(dbHealth);
+        // Check native modules
+        const nativeHealth = this.checkNativeModulesHealth();
+        components.push(nativeHealth);
+        // Check file system access
+        const fsHealth = await this.checkFileSystemHealth();
+        components.push(fsHealth);
+        // Check system resources
+        const systemHealth = await this.checkSystemResources();
+        components.push(systemHealth);
+        // Check performance metrics
+        const perfHealth = this.checkPerformanceMetrics();
+        components.push(perfHealth);
+        // Determine overall status
+        const unhealthyComponents = components.filter(c => c.status === 'unhealthy');
+        const degradedComponents = components.filter(c => c.status === 'degraded');
+        let overallStatus = 'healthy';
+        if (unhealthyComponents.length > 0) {
+            overallStatus = 'unhealthy';
+        }
+        else if (degradedComponents.length > 0) {
+            overallStatus = 'degraded';
+        }
+        // Get system info
+        const systemInfo = await this.getSystemInfo();
+        // Collect performance metrics
+        const metrics = performanceMonitor.getAllStats();
+        return {
+            timestamp: Date.now(),
+            uptime: Date.now() - this.startTime,
+            status: overallStatus,
+            components,
+            system: systemInfo,
+            metrics
+        };
+    }
+    /**
+     * Check database health
+     */
+    async checkDatabaseHealth() {
+        try {
+            // Try a simple query to test database connectivity
+            const result = await db.run('SELECT 1 as a'); // Valid CozoDB query
+            if (result && result.rows) {
+                return {
+                    name: 'database',
+                    status: 'healthy',
+                    message: 'Database connection and query execution successful',
+                    details: {
+                        querySuccess: true,
+                        rowCount: result.rows.length
+                    }
+                };
+            }
+            else {
+                return {
+                    name: 'database',
+                    status: 'degraded',
+                    message: 'Database connection established but query returned no results',
+                    details: {
+                        querySuccess: false
+                    }
+                };
+            }
+        }
+        catch (error) {
+            return {
+                name: 'database',
+                status: 'unhealthy',
+                message: `Database connection failed: ${error.message}`,
+                details: {
+                    error: error.message,
+                    stack: error.stack
+                }
+            };
+        }
+    }
+    /**
+     * Check native modules health
+     */
+    checkNativeModulesHealth() {
+        try {
+            const status = nativeModuleManager.getAllStatus();
+            // Check if critical native modules are loaded
+            const eceNativeStatus = status.get('ece_native');
+            if (!eceNativeStatus) {
+                return {
+                    name: 'native-modules',
+                    status: 'unhealthy',
+                    message: 'Native module manager not initialized properly'
+                };
+            }
+            if (!eceNativeStatus.loaded) {
+                return {
+                    name: 'native-modules',
+                    status: 'degraded',
+                    message: 'Native modules not loaded, using fallback implementations',
+                    details: {
+                        fallbackActive: eceNativeStatus.fallbackActive,
+                        error: eceNativeStatus.error
+                    }
+                };
+            }
+            // Test native module functionality if loaded
+            if (!eceNativeStatus.fallbackActive) {
+                try {
+                    const native = nativeModuleManager.loadNativeModule('ece_native', 'ece_native.node');
+                    // Test basic functionality
+                    if (typeof native?.fingerprint === 'function') {
+                        const testHash = native.fingerprint('health check test');
+                        if (typeof testHash !== 'undefined') {
+                            return {
+                                name: 'native-modules',
+                                status: 'healthy',
+                                message: 'Native modules loaded and functional',
+                                details: {
+                                    modulesLoaded: Array.from(status.keys()),
+                                    fallbackActive: eceNativeStatus.fallbackActive
+                                }
+                            };
+                        }
+                    }
+                }
+                catch (error) {
+                    return {
+                        name: 'native-modules',
+                        status: 'degraded',
+                        message: `Native module functionality test failed: ${error.message}`,
+                        details: {
+                            error: error.message
+                        }
+                    };
+                }
+            }
+            return {
+                name: 'native-modules',
+                status: eceNativeStatus.fallbackActive ? 'degraded' : 'healthy',
+                message: eceNativeStatus.fallbackActive ? 'Native modules loaded with fallback implementations' : 'Native modules loaded and operational',
+                details: {
+                    fallbackActive: eceNativeStatus.fallbackActive,
+                    error: eceNativeStatus.error
+                }
+            };
+        }
+        catch (error) {
+            return {
+                name: 'native-modules',
+                status: 'unhealthy',
+                message: `Native module check failed: ${error.message}`,
+                details: {
+                    error: error.message
+                }
+            };
+        }
+    }
+    /**
+     * Check file system health
+     */
+    async checkFileSystemHealth() {
+        try {
+            // Check critical directories
+            const criticalPaths = [
+                pathManager.getDatabasePath(),
+                pathManager.getNotebookDir(),
+                pathManager.getContextDir(),
+                pathManager.getLogsDir()
+            ];
+            for (const path of criticalPaths) {
+                try {
+                    await fs.access(path);
+                }
+                catch (error) {
+                    // If it's the database path and it doesn't exist, that's OK - it will be created
+                    if (path === pathManager.getDatabasePath()) {
+                        // Use path.dirname to safely get parent directory on all platforms
+                        const importPath = await import('path');
+                        const dbDir = pathManager.getDatabasePath();
+                        const parentDir = importPath.dirname(dbDir);
+                        const dbDirExists = await this.pathExists(parentDir);
+                        if (!dbDirExists) {
+                            return {
+                                name: 'filesystem',
+                                status: 'unhealthy',
+                                message: `Database directory does not exist and cannot be accessed: ${parentDir}`
+                            };
+                        }
+                    }
+                    else {
+                        return {
+                            name: 'filesystem',
+                            status: 'unhealthy',
+                            message: `Critical path not accessible: ${path}`
+                        };
+                    }
+                }
+            }
+            return {
+                name: 'filesystem',
+                status: 'healthy',
+                message: 'All critical paths accessible',
+                details: {
+                    checkedPaths: criticalPaths
+                }
+            };
+        }
+        catch (error) {
+            return {
+                name: 'filesystem',
+                status: 'unhealthy',
+                message: `File system check failed: ${error.message}`,
+                details: {
+                    error: error.message
+                }
+            };
+        }
+    }
+    /**
+     * Check system resources
+     */
+    async checkSystemResources() {
+        try {
+            const systemInfo = await this.getSystemInfo();
+            // Define thresholds
+            const MEMORY_THRESHOLD = 0.1; // 10% minimum free memory
+            const DISK_THRESHOLD = 0.05; // 5% minimum free disk space
+            const memoryOk = (systemInfo.freeMemory / systemInfo.totalMemory) > MEMORY_THRESHOLD;
+            const diskOk = (systemInfo.diskSpace.available / systemInfo.diskSpace.total) > DISK_THRESHOLD;
+            if (!memoryOk || !diskOk) {
+                const messages = [];
+                if (!memoryOk)
+                    messages.push(`Low memory: ${(systemInfo.freeMemory / (1024 ** 3)).toFixed(2)}GB free`);
+                if (!diskOk)
+                    messages.push(`Low disk space: ${(systemInfo.diskSpace.available / (1024 ** 3)).toFixed(2)}GB available`);
+                return {
+                    name: 'system-resources',
+                    status: 'degraded',
+                    message: `System resources below threshold: ${messages.join(', ')}`,
+                    details: systemInfo
+                };
+            }
+            return {
+                name: 'system-resources',
+                status: 'healthy',
+                message: 'System resources within acceptable ranges',
+                details: systemInfo
+            };
+        }
+        catch (error) {
+            return {
+                name: 'system-resources',
+                status: 'unhealthy',
+                message: `System resource check failed: ${error.message}`,
+                details: {
+                    error: error.message
+                }
+            };
+        }
+    }
+    /**
+     * Check performance metrics
+     */
+    checkPerformanceMetrics() {
+        try {
+            const metrics = performanceMonitor.getAllStats();
+            const slowOperations = performanceMonitor.getSlowestOperations(3);
+            const busyOperations = performanceMonitor.getBusiestOperations(3);
+            // Check if any operations are taking too long (threshold: 5 seconds)
+            const slowOpFound = slowOperations.some(op => op.averageDuration > 5000);
+            if (slowOpFound) {
+                return {
+                    name: 'performance-metrics',
+                    status: 'degraded',
+                    message: 'Some operations are taking longer than expected (>5s average)',
+                    details: {
+                        slowOperations,
+                        busyOperations,
+                        metrics
+                    }
+                };
+            }
+            return {
+                name: 'performance-metrics',
+                status: 'healthy',
+                message: 'Performance metrics within acceptable ranges',
+                details: {
+                    slowOperations,
+                    busyOperations,
+                    metrics
+                }
+            };
+        }
+        catch (error) {
+            return {
+                name: 'performance-metrics',
+                status: 'unhealthy',
+                message: `Performance metrics check failed: ${error.message}`,
+                details: {
+                    error: error.message
+                }
+            };
+        }
+    }
+    /**
+     * Get system information
+     */
+    async getSystemInfo() {
+        const platform = os.platform();
+        const arch = os.arch();
+        const totalMemory = os.totalmem();
+        const freeMemory = os.freemem();
+        const cpuCount = os.cpus().length;
+        const loadAverage = os.loadavg();
+        // Get disk space info (approximate)
+        const diskSpace = await this.getDiskSpaceInfo();
+        // Get process information
+        const processInfo = this.getProcessInfo();
+        return {
+            platform,
+            arch,
+            totalMemory,
+            freeMemory,
+            cpuCount,
+            loadAverage,
+            diskSpace,
+            processInfo
+        };
+    }
+    /**
+     * Get process-specific information
+     */
+    getProcessInfo() {
+        const memoryUsage = process.memoryUsage();
+        const uptime = process.uptime();
+        // Calculate CPU usage approximation
+        // Note: This is a simplified calculation; for more accurate CPU usage, 
+        // you'd need to track over time
+        const cpuUsage = 0; // Placeholder - would need time-based calculation
+        return {
+            pid: process.pid,
+            memoryUsage,
+            uptime,
+            cpuUsage
+        };
+    }
+    /**
+     * Get disk space information
+     */
+    async getDiskSpaceInfo() {
+        // This is a simplified implementation
+        // In a real implementation, you might use a library like 'diskusage'
+        try {
+            // For now, return dummy values based on available memory as a proxy
+            // In a real implementation, use proper disk space checking
+            const total = 1024 * 1024 * 1024 * 500; // 500GB dummy value
+            const available = 1024 * 1024 * 1024 * 100; // 100GB dummy value
+            return {
+                total,
+                available,
+                used: total - available
+            };
+        }
+        catch (error) {
+            // Return safe defaults if we can't determine actual values
+            return {
+                total: 1024 * 1024 * 1024 * 500, // 500GB
+                available: 1024 * 1024 * 1024 * 100, // 100GB
+                used: 1024 * 1024 * 1024 * 400 // 400GB
+            };
+        }
+    }
+    /**
+     * Check if a path exists
+     */
+    async pathExists(path) {
+        try {
+            await fs.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// Export singleton instance
+export const healthCheckService = HealthCheckService.getInstance();
+//# sourceMappingURL=health-check-enhanced.js.map

package/engine/dist/services/health-check-enhanced.js.map

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

package/engine/dist/services/idle-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Idle Manager for Anchor OS
+ *
+ * Detects system inactivity and triggers memory cleanup to reduce RAM usage
+ * during idle periods. Coordinates with all services to release resources.
+ *
+ * @see MEMORY_OPTIMIZATION_PLAN.md for full details
+ */
+export interface IdleManagerConfig {
+    idleTimeoutMinutes: number;
+    enabled: boolean;
+    enableModelUnload: boolean;
+    enableMetricsPrune: boolean;
+    enableGC: boolean;
+}
+export declare class IdleManager {
+    private static instance;
+    private lastActivityTime;
+    private idleTimeout;
+    private config;
+    private isIdle;
+    private activityCounter;
+    private constructor();
+    static getInstance(): IdleManager;
+    /**
+     * Mark system as active (call this on any user request)
+     */
+    markActive(reason?: string): void;
+    /**
+     * Configure idle manager settings
+     */
+    configure(config: Partial<IdleManagerConfig>): void;
+    /**
+     * Get current idle status
+     */
+    getStatus(): {
+        isIdle: boolean;
+        idleTimeoutMinutes: number;
+        minutesUntilIdle: number;
+        activityCount: number;
+        lastActivityAgo: number;
+    };
+    /**
+     * Manually trigger idle mode (for testing)
+     */
+    triggerIdleMode(): Promise<void>;
+    /**
+     * Reset activity counter (for testing)
+     */
+    resetActivityCounter(): void;
+    private scheduleIdleCheck;
+    private enterIdleMode;
+    private startMonitoring;
+}
+export declare const idleManager: IdleManager;
+//# sourceMappingURL=idle-manager.d.ts.map

package/engine/dist/services/idle-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-manager.d.ts","sourceRoot":"","sources":["../../src/services/idle-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAa;IAEpC,OAAO;WAiBO,WAAW,IAAI,WAAW;IAOxC;;OAEG;IACI,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM;IAsBjC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAW1D;;OAEG;IACI,SAAS,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;KACzB;IAcD;;OAEG;IACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7C;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAInC,OAAO,CAAC,iBAAiB;YAeX,aAAa;IAqF3B,OAAO,CAAC,eAAe;CAYxB;AAGD,eAAO,MAAM,WAAW,aAA4B,CAAC"}