tywrap 0.1.0

package/dist/utils/memory-profiler.js

@@ -0,0 +1,426 @@
+/**
+ * Memory Profiler and Leak Detection for tywrap
+ * Comprehensive memory monitoring and analysis tools
+ */
+import { EventEmitter } from 'events';
+import { writeFileSync } from 'fs';
+import { getComponentLogger } from './logger.js';
+const log = getComponentLogger('MemoryProfiler');
+export class MemoryProfiler extends EventEmitter {
+    snapshots = [];
+    operationMetrics = new Map();
+    monitoring = false;
+    monitoringInterval;
+    baselineSnapshot;
+    gcCount = 0;
+    options;
+    constructor(options = {}) {
+        super();
+        this.options = {
+            snapshotInterval: 5000, // 5 seconds
+            maxSnapshots: 100,
+            leakThreshold: 1024 * 1024, // 1MB per second
+            enableGCTracking: true,
+            ...options,
+        };
+        if (this.options.enableGCTracking) {
+            this.setupGCTracking();
+        }
+    }
+    logInfo(message) {
+        process.stdout.write(`${message}\n`);
+    }
+    /**
+     * Start memory monitoring
+     */
+    startMonitoring() {
+        if (this.monitoring) {
+            return;
+        }
+        this.monitoring = true;
+        this.baselineSnapshot = this.takeSnapshot('monitoring_start');
+        this.monitoringInterval = setInterval(() => {
+            const snapshot = this.takeSnapshot('periodic');
+            this.emit('snapshot', snapshot);
+            // Check for immediate leak concerns
+            const analysis = this.analyzeLeaks();
+            if (analysis.detected && analysis.severity === 'critical') {
+                this.emit('critical_leak', analysis);
+            }
+        }, this.options.snapshotInterval);
+        this.logInfo('Memory monitoring started');
+    }
+    /**
+     * Stop memory monitoring
+     */
+    stopMonitoring() {
+        if (!this.monitoring) {
+            return;
+        }
+        this.monitoring = false;
+        if (this.monitoringInterval) {
+            clearInterval(this.monitoringInterval);
+            this.monitoringInterval = undefined;
+        }
+        this.takeSnapshot('monitoring_stop');
+        this.emit('monitoring_stopped', this.generateReport());
+        this.logInfo('Memory monitoring stopped');
+    }
+    /**
+     * Take a memory snapshot
+     */
+    takeSnapshot(operation, metadata) {
+        const memUsage = process.memoryUsage();
+        const snapshot = {
+            timestamp: Date.now(),
+            heapUsed: memUsage.heapUsed,
+            heapTotal: memUsage.heapTotal,
+            external: memUsage.external,
+            rss: memUsage.rss,
+            arrayBuffers: memUsage.arrayBuffers,
+            gcCount: this.gcCount,
+            operation,
+            metadata,
+        };
+        this.snapshots.push(snapshot);
+        // Keep only recent snapshots
+        if (this.snapshots.length > this.options.maxSnapshots) {
+            this.snapshots.shift();
+        }
+        return snapshot;
+    }
+    /**
+     * Profile a specific operation
+     */
+    async profileOperation(operationName, operation, metadata) {
+        // Force garbage collection if available
+        if (global.gc) {
+            global.gc();
+            await this.sleep(100); // Let GC settle
+        }
+        const beforeSnapshot = this.takeSnapshot(`${operationName}_start`, metadata);
+        const startTime = performance.now();
+        try {
+            const result = await operation();
+            const endTime = performance.now();
+            // Force GC again to get accurate measurement
+            if (global.gc) {
+                global.gc();
+                await this.sleep(100);
+            }
+            const afterSnapshot = this.takeSnapshot(`${operationName}_end`, metadata);
+            const memoryDelta = afterSnapshot.heapUsed - beforeSnapshot.heapUsed;
+            const duration = endTime - startTime;
+            // Update operation metrics
+            const existing = this.operationMetrics.get(operationName) ?? {
+                count: 0,
+                averageMemoryDelta: 0,
+                maxMemoryDelta: 0,
+                totalMemoryAllocated: 0,
+            };
+            existing.count++;
+            existing.totalMemoryAllocated += Math.max(0, memoryDelta);
+            existing.maxMemoryDelta = Math.max(existing.maxMemoryDelta, memoryDelta);
+            existing.averageMemoryDelta = existing.totalMemoryAllocated / existing.count;
+            this.operationMetrics.set(operationName, existing);
+            this.logInfo(`${operationName}: ${duration.toFixed(2)}ms, ${this.formatBytes(memoryDelta)} memory delta`);
+            return { result, memoryDelta, duration };
+        }
+        catch (error) {
+            this.takeSnapshot(`${operationName}_error`, { ...metadata, error: String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Analyze potential memory leaks
+     */
+    analyzeLeaks() {
+        if (this.snapshots.length < 3) {
+            return {
+                detected: false,
+                severity: 'low',
+                growthRate: 0,
+                suspiciousOperations: [],
+                recommendations: [],
+                snapshots: this.snapshots,
+            };
+        }
+        const recentSnapshots = this.snapshots.slice(-10); // Last 10 snapshots
+        const lastSnapshot = recentSnapshots[recentSnapshots.length - 1];
+        const firstSnapshot = recentSnapshots[0];
+        if (!lastSnapshot || !firstSnapshot) {
+            return {
+                detected: false,
+                severity: 'low',
+                growthRate: 0,
+                suspiciousOperations: [],
+                recommendations: [],
+                snapshots: this.snapshots,
+            };
+        }
+        const timeSpan = lastSnapshot.timestamp - firstSnapshot.timestamp;
+        if (timeSpan === 0) {
+            return {
+                detected: false,
+                severity: 'low',
+                growthRate: 0,
+                suspiciousOperations: [],
+                recommendations: [],
+                snapshots: this.snapshots,
+            };
+        }
+        const memoryGrowth = lastSnapshot.heapUsed - firstSnapshot.heapUsed;
+        const growthRate = (memoryGrowth / timeSpan) * 1000; // bytes per second
+        // Detect leak severity
+        let detected = false;
+        let severity = 'low';
+        if (growthRate > this.options.leakThreshold) {
+            detected = true;
+            if (growthRate > this.options.leakThreshold * 5) {
+                severity = 'critical';
+            }
+            else if (growthRate > this.options.leakThreshold * 3) {
+                severity = 'high';
+            }
+            else if (growthRate > this.options.leakThreshold * 1.5) {
+                severity = 'medium';
+            }
+        }
+        // Find suspicious operations
+        const suspiciousOperations = this.identifySuspiciousOperations();
+        // Generate recommendations
+        const recommendations = this.generateRecommendations(growthRate, suspiciousOperations);
+        return {
+            detected,
+            severity,
+            growthRate,
+            suspiciousOperations,
+            recommendations,
+            snapshots: recentSnapshots,
+        };
+    }
+    /**
+     * Identify operations that may be causing memory leaks
+     */
+    identifySuspiciousOperations() {
+        const suspicious = [];
+        for (const [operation, metrics] of this.operationMetrics) {
+            // High average memory usage
+            if (metrics.averageMemoryDelta > 10 * 1024 * 1024) {
+                // 10MB average
+                suspicious.push(`${operation}: High average memory usage (${this.formatBytes(metrics.averageMemoryDelta)})`);
+            }
+            // Memory growth without proper cleanup
+            if (metrics.count > 5 && metrics.averageMemoryDelta > 1024 * 1024) {
+                // 1MB average over 5 calls
+                suspicious.push(`${operation}: Potential memory accumulation`);
+            }
+            // Very large single allocation
+            if (metrics.maxMemoryDelta > 50 * 1024 * 1024) {
+                // 50MB single allocation
+                suspicious.push(`${operation}: Very large memory allocation (${this.formatBytes(metrics.maxMemoryDelta)})`);
+            }
+        }
+        return suspicious;
+    }
+    /**
+     * Generate recommendations based on analysis
+     */
+    generateRecommendations(growthRate, suspiciousOperations) {
+        const recommendations = [];
+        if (growthRate > this.options.leakThreshold) {
+            recommendations.push('Memory leak detected - investigate resource cleanup in your code');
+            if (suspiciousOperations.length > 0) {
+                recommendations.push(`Focus on these operations: ${suspiciousOperations.slice(0, 3).join(', ')}`);
+            }
+            if (growthRate > this.options.leakThreshold * 5) {
+                recommendations.push('CRITICAL: Memory growing very rapidly - immediate action required');
+                recommendations.push('Consider restarting the process if growth continues');
+            }
+            recommendations.push('Enable garbage collection with --expose-gc for better measurements');
+            recommendations.push('Review cache expiration policies');
+            recommendations.push('Check for retained references to large objects');
+            recommendations.push('Monitor subprocess memory usage in Python bridge');
+        }
+        // General performance recommendations
+        if (this.operationMetrics.size > 0) {
+            const avgMemoryPerOp = Array.from(this.operationMetrics.values()).reduce((sum, m) => sum + m.averageMemoryDelta, 0) / this.operationMetrics.size;
+            if (avgMemoryPerOp > 5 * 1024 * 1024) {
+                // 5MB average
+                recommendations.push('Consider optimizing data structures for lower memory usage');
+                recommendations.push('Implement streaming for large data processing');
+            }
+        }
+        return recommendations;
+    }
+    /**
+     * Generate comprehensive memory report
+     */
+    generateReport() {
+        if (this.snapshots.length === 0) {
+            throw new Error('No memory snapshots available for report');
+        }
+        const firstSnapshot = this.snapshots[0];
+        const lastSnapshot = this.snapshots[this.snapshots.length - 1];
+        if (!firstSnapshot || !lastSnapshot) {
+            throw new Error('Invalid snapshot data for report generation');
+        }
+        const duration = lastSnapshot.timestamp - firstSnapshot.timestamp;
+        const heapValues = this.snapshots.map(s => s.heapUsed);
+        const peakMemory = Math.max(...heapValues);
+        const averageMemory = heapValues.reduce((sum, val) => sum + val, 0) / heapValues.length;
+        const memoryGrowth = lastSnapshot.heapUsed - firstSnapshot.heapUsed;
+        // Calculate GC efficiency
+        const gcEvents = this.snapshots.filter((s, i) => {
+            const prevSnapshot = this.snapshots[i - 1];
+            return i > 0 && prevSnapshot && s.gcCount > prevSnapshot.gcCount;
+        });
+        const gcEfficiency = gcEvents.length > 0
+            ? gcEvents.reduce((sum, s) => {
+                const prev = this.snapshots[this.snapshots.indexOf(s) - 1];
+                const memoryReclaimed = prev ? prev.heapUsed - s.heapUsed : 0;
+                return sum + Math.max(0, memoryReclaimed);
+            }, 0) / gcEvents.length
+            : 0;
+        const summary = {
+            duration,
+            totalOperations: Array.from(this.operationMetrics.values()).reduce((sum, m) => sum + m.count, 0),
+            peakMemory,
+            averageMemory,
+            memoryGrowth,
+            gcEfficiency,
+        };
+        const leakAnalysis = this.analyzeLeaks();
+        // Generate overall recommendations
+        const recommendations = [];
+        if (summary.peakMemory > 500 * 1024 * 1024) {
+            // 500MB peak
+            recommendations.push('High peak memory usage detected - consider memory optimization strategies');
+        }
+        if (summary.memoryGrowth > 100 * 1024 * 1024) {
+            // 100MB growth
+            recommendations.push('Significant memory growth over session - review for potential leaks');
+        }
+        if (summary.gcEfficiency < 1024 * 1024) {
+            // Less than 1MB reclaimed per GC
+            recommendations.push('Low GC efficiency - may indicate memory fragmentation or retained references');
+        }
+        return {
+            summary,
+            leakAnalysis,
+            operationMetrics: this.operationMetrics,
+            recommendations: [...recommendations, ...leakAnalysis.recommendations],
+        };
+    }
+    /**
+     * Save memory report to file
+     */
+    saveReport(filePath) {
+        const report = this.generateReport();
+        const reportData = {
+            timestamp: new Date().toISOString(),
+            report,
+            snapshots: this.snapshots,
+        };
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- caller controls report path
+        writeFileSync(filePath, JSON.stringify(reportData, null, 2));
+        this.logInfo(`Memory report saved to ${filePath}`);
+        return report;
+    }
+    /**
+     * Setup garbage collection tracking
+     */
+    setupGCTracking() {
+        if (typeof global.gc !== 'function') {
+            log.warn('GC tracking unavailable - run with --expose-gc for better memory analysis');
+            return;
+        }
+        // Hook into GC events if available
+        try {
+            if (process.versions.node >= '14.0.0') {
+                const perfHooks = require('perf_hooks');
+                const obs = new perfHooks.PerformanceObserver((list) => {
+                    const entries = list.getEntries();
+                    entries.forEach(entry => {
+                        if (entry.entryType === 'gc') {
+                            this.gcCount++;
+                            this.emit('gc', {
+                                type: entry.kind,
+                                duration: entry.duration,
+                                timestamp: Date.now(),
+                            });
+                        }
+                    });
+                });
+                obs.observe({ entryTypes: ['gc'] });
+            }
+        }
+        catch (error) {
+            log.warn('Advanced GC tracking unavailable', { error: String(error) });
+        }
+    }
+    /**
+     * Format bytes for human readable output
+     */
+    formatBytes(bytes) {
+        if (bytes === 0) {
+            return '0 B';
+        }
+        const k = 1024;
+        const sizes = ['B', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(Math.abs(bytes)) / Math.log(k));
+        const size = bytes / Math.pow(k, i);
+        const sign = bytes < 0 ? '-' : '+';
+        const sizeLabel = i === 0 ? sizes[0] : i === 1 ? sizes[1] : i === 2 ? sizes[2] : sizes[3];
+        return `${sign}${size.toFixed(1)} ${sizeLabel}`;
+    }
+    /**
+     * Utility sleep function
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Clear all collected data
+     */
+    clear() {
+        this.snapshots.length = 0;
+        this.operationMetrics.clear();
+        this.gcCount = 0;
+        this.baselineSnapshot = undefined;
+    }
+    /**
+     * Get current memory usage
+     */
+    getCurrentMemoryUsage() {
+        return this.takeSnapshot('current');
+    }
+    /**
+     * Check if profiler has snapshots
+     */
+    hasSnapshots() {
+        return this.snapshots.length > 0;
+    }
+    /**
+     * Dispose profiler
+     */
+    dispose() {
+        this.stopMonitoring();
+        this.clear();
+        this.removeAllListeners();
+    }
+}
+// Export singleton instance for global use
+export const globalMemoryProfiler = new MemoryProfiler();
+// Automatic profiling for process exit
+process.on('exit', () => {
+    if (globalMemoryProfiler.hasSnapshots()) {
+        try {
+            globalMemoryProfiler.saveReport('memory-profile-exit.json');
+        }
+        catch (error) {
+            log.error('Failed to save exit memory report', { error: String(error) });
+        }
+    }
+});
+//# sourceMappingURL=memory-profiler.js.map

package/dist/utils/memory-profiler.js.map

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

package/dist/utils/parallel-processor.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Parallel Processing System for tywrap
+ * High-performance parallel processing for large Python codebases
+ */
+import { EventEmitter } from 'events';
+import type { AnalysisResult, PythonModule, GeneratedCode } from '../types/index.js';
+export interface ParallelTask<Data = unknown> {
+    id: string;
+    type: 'analyze' | 'generate' | 'validate' | 'custom';
+    data: Data;
+    options?: Record<string, unknown>;
+    priority?: number;
+    timeout?: number;
+}
+export interface ParallelResult<T = unknown> {
+    taskId: string;
+    success: boolean;
+    result?: T;
+    error?: string;
+    duration: number;
+    memoryUsage?: number;
+}
+export interface WorkerStats {
+    workerId: string;
+    tasksCompleted: number;
+    totalTime: number;
+    averageTime: number;
+    errorCount: number;
+    memoryPeak: number;
+    isActive: boolean;
+}
+export interface ParallelProcessorOptions {
+    maxWorkers?: number;
+    taskTimeout?: number;
+    retryAttempts?: number;
+    enableMemoryMonitoring?: boolean;
+    enableCaching?: boolean;
+    workerScript?: string;
+    batchSize?: number;
+    loadBalancing?: 'round-robin' | 'least-loaded' | 'weighted';
+    debug?: boolean;
+}
+export interface ParallelProcessorStats {
+    activeWorkers: number;
+    totalWorkers: number;
+    tasksCompleted: number;
+    totalErrors: number;
+    averageTaskTime: number;
+    queueLength: number;
+    activeTasks: number;
+    workerStats: WorkerStats[];
+}
+export declare class ParallelProcessor extends EventEmitter {
+    private workers;
+    private workerStats;
+    private taskQueue;
+    private activeTasks;
+    private pendingResults;
+    private roundRobinIndex;
+    private options;
+    private disposed;
+    private debug;
+    constructor(options?: ParallelProcessorOptions);
+    private debugLog;
+    /**
+     * Initialize worker pool
+     */
+    init(): Promise<void>;
+    /**
+     * Process Python module analysis in parallel
+     */
+    analyzeModulesParallel(sources: Array<{
+        name: string;
+        content: string;
+        path?: string;
+    }>, options?: {
+        chunkSize?: number;
+    }): Promise<Array<ParallelResult<AnalysisResult>>>;
+    /**
+     * Generate TypeScript wrappers in parallel
+     */
+    generateWrappersParallel(modules: Array<{
+        name: string;
+        module: PythonModule;
+        options?: Record<string, unknown>;
+    }>, options?: {
+        chunkSize?: number;
+    }): Promise<Array<ParallelResult<GeneratedCode>>>;
+    /**
+     * Execute tasks in parallel with load balancing
+     */
+    executeTasks<Data, Result>(tasks: ParallelTask<Data>[]): Promise<Array<ParallelResult<Result>>>;
+    /**
+     * Execute single task
+     */
+    private executeTask;
+    /**
+     * Select optimal worker using load balancing strategy
+     */
+    private selectOptimalWorker;
+    /**
+     * Send task to specific worker
+     */
+    private sendTaskToWorker;
+    /**
+     * Spawn new worker
+     */
+    private spawnWorker;
+    /**
+     * Handle message from worker
+     */
+    private handleWorkerMessage;
+    /**
+     * Handle worker error
+     */
+    private handleWorkerError;
+    /**
+     * Handle worker exit
+     */
+    private handleWorkerExit;
+    /**
+     * Process task queue
+     */
+    private processQueue;
+    /**
+     * Get worker statistics
+     */
+    getWorkerStats(): WorkerStats[];
+    /**
+     * Get overall processing statistics
+     */
+    getStats(): ParallelProcessorStats;
+    /**
+     * Utility methods
+     */
+    private chunkArray;
+    private getWorkerId;
+    private sleep;
+    /**
+     * Gracefully dispose all workers
+     */
+    dispose(): Promise<void>;
+    setDebug(debug: boolean): void;
+}
+export declare const globalParallelProcessor: ParallelProcessor;
+//# sourceMappingURL=parallel-processor.d.ts.map

package/dist/utils/parallel-processor.d.ts.map

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