@rbalchii/anchor-engine 4.7.0

package/engine/dist/utils/request-tracer.js

@@ -0,0 +1,414 @@
+/**
+ * Request Tracing System for Anchor Engine
+ *
+ * Implements comprehensive request tracing for debugging and monitoring
+ * following Standard 078: Process Isolation & Live Diagnostics
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { logWithContext } from '../utils/structured-logger.js';
+import { performanceMonitor } from '../utils/performance-monitor.js';
+export class RequestTracer {
+    static instance;
+    activeSpans;
+    traceContext;
+    constructor() {
+        this.activeSpans = new Map();
+        this.traceContext = new WeakMap();
+    }
+    static getInstance() {
+        if (!RequestTracer.instance) {
+            RequestTracer.instance = new RequestTracer();
+        }
+        return RequestTracer.instance;
+    }
+    /**
+     * Start a new trace for a request
+     */
+    startTrace(operation, tags) {
+        const traceId = uuidv4();
+        const spanId = uuidv4();
+        const span = {
+            id: spanId,
+            traceId,
+            operation,
+            startTime: Date.now(),
+            status: 'started',
+            tags
+        };
+        this.activeSpans.set(spanId, span);
+        const context = {
+            traceId,
+            spanId
+        };
+        logWithContext.info('TRACE_START', {
+            traceId,
+            spanId,
+            operation,
+            tags
+        });
+        return context;
+    }
+    /**
+     * Start a child span within a trace
+     */
+    startChildSpan(parentContext, operation, tags) {
+        const spanId = uuidv4();
+        const span = {
+            id: spanId,
+            parentId: parentContext.spanId,
+            traceId: parentContext.traceId,
+            operation,
+            startTime: Date.now(),
+            status: 'started',
+            tags
+        };
+        this.activeSpans.set(spanId, span);
+        const context = {
+            traceId: parentContext.traceId,
+            spanId,
+            parentId: parentContext.spanId
+        };
+        logWithContext.info('SPAN_START', {
+            traceId: parentContext.traceId,
+            spanId,
+            parentId: parentContext.spanId,
+            operation,
+            tags
+        });
+        return context;
+    }
+    /**
+     * End a trace span
+     */
+    endTrace(context, status = 'completed', tags) {
+        const span = this.activeSpans.get(context.spanId);
+        if (!span) {
+            logWithContext.warn('Attempted to end non-existent span', {
+                spanId: context.spanId,
+                traceId: context.traceId
+            });
+            return;
+        }
+        span.endTime = Date.now();
+        span.duration = span.endTime - span.startTime;
+        span.status = status;
+        if (tags) {
+            span.tags = { ...span.tags, ...tags };
+        }
+        // Update the span in the map
+        this.activeSpans.set(context.spanId, span);
+        logWithContext.info('TRACE_END', {
+            traceId: context.traceId,
+            spanId: context.spanId,
+            operation: span.operation,
+            duration: span.duration,
+            status,
+            tags
+        });
+        // Record performance metric
+        if (span.duration) {
+            performanceMonitor.recordOperation(`${span.operation}_duration`, span.duration);
+        }
+    }
+    /**
+     * Add a log to a trace span
+     */
+    addLog(context, level, message, fields) {
+        const span = this.activeSpans.get(context.spanId);
+        if (!span) {
+            return; // Silently fail if span doesn't exist
+        }
+        if (!span.logs) {
+            span.logs = [];
+        }
+        span.logs.push({
+            timestamp: Date.now(),
+            level,
+            message,
+            fields
+        });
+        // Update the span in the map
+        this.activeSpans.set(context.spanId, span);
+    }
+    /**
+     * Add tags to a trace span
+     */
+    addTags(context, tags) {
+        const span = this.activeSpans.get(context.spanId);
+        if (!span) {
+            return; // Silently fail if span doesn't exist
+        }
+        if (!span.tags) {
+            span.tags = {};
+        }
+        span.tags = { ...span.tags, ...tags };
+        // Update the span in the map
+        this.activeSpans.set(context.spanId, span);
+    }
+    /**
+     * Get trace information for debugging
+     */
+    getTrace(traceId) {
+        const spans = Array.from(this.activeSpans.values()).filter(span => span.traceId === traceId);
+        return spans.length > 0 ? spans : null;
+    }
+    /**
+     * Get active spans for a trace
+     */
+    getActiveSpans(traceId) {
+        return Array.from(this.activeSpans.values()).filter(span => span.traceId === traceId && span.status === 'started');
+    }
+    /**
+     * Get all completed spans for a trace
+     */
+    getCompletedSpans(traceId) {
+        return Array.from(this.activeSpans.values()).filter(span => span.traceId === traceId && span.status === 'completed');
+    }
+    /**
+     * Get trace summary
+     */
+    getTraceSummary(traceId) {
+        const allSpans = this.getTrace(traceId);
+        if (!allSpans)
+            return null;
+        const completedSpans = allSpans.filter(s => s.status === 'completed');
+        const errorSpans = allSpans.filter(s => s.status === 'error');
+        const totalDuration = Math.max(...allSpans.map(s => s.duration || 0));
+        const operations = [...new Set(allSpans.map(s => s.operation))];
+        return {
+            traceId,
+            totalSpans: allSpans.length,
+            completedSpans: completedSpans.length,
+            errorSpans: errorSpans.length,
+            totalDuration,
+            operations
+        };
+    }
+    /**
+     * Export trace data for external analysis
+     */
+    exportTrace(traceId) {
+        const spans = this.getTrace(traceId);
+        if (!spans)
+            return null;
+        // Format for OpenTelemetry-compatible export
+        return {
+            traceId,
+            spans: spans.map(span => ({
+                spanId: span.id,
+                parentId: span.parentId,
+                operation: span.operation,
+                startTime: new Date(span.startTime).toISOString(),
+                endTime: span.endTime ? new Date(span.endTime).toISOString() : null,
+                duration: span.duration,
+                status: span.status,
+                tags: span.tags || {},
+                logs: span.logs || []
+            }))
+        };
+    }
+    /**
+     * Clear expired traces (older than specified minutes)
+     */
+    clearExpiredTraces(maxAgeMinutes = 30) {
+        const cutoffTime = Date.now() - (maxAgeMinutes * 60 * 1000);
+        let clearedCount = 0;
+        for (const [spanId, span] of this.activeSpans.entries()) {
+            // If span is completed and older than maxAge, remove it
+            if (span.status !== 'started' && span.endTime && span.endTime < cutoffTime) {
+                this.activeSpans.delete(spanId);
+                clearedCount++;
+            }
+        }
+        return clearedCount;
+    }
+    /**
+     * Get all trace IDs
+     */
+    getAllTraceIds() {
+        const traceIds = new Set();
+        for (const span of this.activeSpans.values()) {
+            traceIds.add(span.traceId);
+        }
+        return Array.from(traceIds);
+    }
+    /**
+     * Get recent traces (sorted by start time)
+     */
+    getRecentTraces(limit = 50) {
+        const traces = Array.from(this.activeSpans.values())
+            .sort((a, b) => b.startTime - a.startTime)
+            .slice(0, limit)
+            .map(span => span.traceId);
+        return [...new Set(traces)]; // Remove duplicates
+    }
+    /**
+     * Get slowest traces based on total duration
+     */
+    getSlowestTraces(limit = 10) {
+        const traceDurations = new Map();
+        for (const span of this.activeSpans.values()) {
+            if (span.duration) {
+                const existing = traceDurations.get(span.traceId) || 0;
+                traceDurations.set(span.traceId, Math.max(existing, span.duration));
+            }
+        }
+        return Array.from(traceDurations.entries())
+            .map(([traceId, duration]) => ({ traceId, duration }))
+            .sort((a, b) => b.duration - a.duration)
+            .slice(0, limit);
+    }
+    /**
+     * Record a performance metric (for compatibility with older code)
+     */
+    record(operation, value) {
+        // For backward compatibility, we'll use the performance monitor if available
+        // This is a simple implementation - in a real system, you'd want to integrate
+        // with the actual performance monitoring system
+        console.log(`[RequestTracer] Recording metric: ${operation} = ${value}`);
+    }
+}
+// Create a global instance
+export const requestTracer = RequestTracer.getInstance();
+// Context manager for request context propagation
+export class RequestContextManager {
+    static contextKey = 'request-context';
+    /**
+     * Set request context in the current execution context
+     */
+    static setContext(context) {
+        // In a real implementation, this would use AsyncLocalStorage or similar
+        // For now, we'll use a global variable as a placeholder
+        global[RequestContextManager.contextKey] = context;
+    }
+    /**
+     * Get request context from the current execution context
+     */
+    static getContext() {
+        const context = global[RequestContextManager.contextKey];
+        return context || null;
+    }
+    /**
+     * Clear request context
+     */
+    static clearContext() {
+        delete global[RequestContextManager.contextKey];
+    }
+    /**
+     * Execute a function with request context
+     */
+    static async withContext(context, fn) {
+        const previousContext = RequestContextManager.getContext();
+        RequestContextManager.setContext(context);
+        try {
+            return await fn();
+        }
+        finally {
+            RequestContextManager.setContext(previousContext || context);
+        }
+    }
+}
+// Export a function to trace an operation
+export async function traceOperation(operation, fn, tags, parentContext) {
+    const context = parentContext
+        ? requestTracer.startChildSpan(parentContext, operation, tags)
+        : requestTracer.startTrace(operation, tags);
+    try {
+        const result = await fn();
+        requestTracer.endTrace(context, 'completed');
+        return result;
+    }
+    catch (error) {
+        requestTracer.endTrace(context, 'error', { error: error.message });
+        throw error;
+    }
+}
+// Export a function to trace an ingestion operation specifically
+export async function traceIngestion(content, source, fn) {
+    const context = requestTracer.startTrace('ingestion', {
+        source,
+        contentLength: content.length,
+        operation: 'ingest'
+    });
+    try {
+        const result = await fn();
+        requestTracer.endTrace(context, 'completed', {
+            status: 'success'
+        });
+        return result;
+    }
+    catch (error) {
+        requestTracer.endTrace(context, 'error', {
+            status: 'failed',
+            error: error.message
+        });
+        throw error;
+    }
+}
+// Export a function to trace a search operation specifically
+export async function traceSearch(query, buckets, fn) {
+    const context = requestTracer.startTrace('search', {
+        query: query.substring(0, 100), // Truncate long queries
+        buckets,
+        operation: 'search'
+    });
+    try {
+        const result = await fn();
+        requestTracer.endTrace(context, 'completed', {
+            status: 'success'
+        });
+        return result;
+    }
+    catch (error) {
+        requestTracer.endTrace(context, 'error', {
+            status: 'failed',
+            error: error.message
+        });
+        throw error;
+    }
+}
+// Export a function to trace a database operation specifically
+export async function traceDatabaseOperation(operation, query, fn) {
+    const context = requestTracer.startTrace(`db_${operation}`, {
+        operation,
+        queryLength: query.length,
+        operationType: 'database'
+    });
+    try {
+        const result = await fn();
+        requestTracer.endTrace(context, 'completed', {
+            status: 'success'
+        });
+        return result;
+    }
+    catch (error) {
+        requestTracer.endTrace(context, 'error', {
+            status: 'failed',
+            error: error.message
+        });
+        throw error;
+    }
+}
+// Export a function to trace a native module operation specifically
+export async function traceNativeOperation(operation, module, fn) {
+    const context = requestTracer.startTrace(`native_${operation}`, {
+        module,
+        operation,
+        operationType: 'native'
+    });
+    try {
+        const result = await fn();
+        requestTracer.endTrace(context, 'completed', {
+            status: 'success'
+        });
+        return result;
+    }
+    catch (error) {
+        requestTracer.endTrace(context, 'error', {
+            status: 'failed',
+            error: error.message
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=request-tracer.js.map

package/engine/dist/utils/request-tracer.js.map

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

package/engine/dist/utils/resource-manager.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Memory Management and Resource Optimization for ECE
+ *
+ * Implements efficient memory usage patterns and resource management
+ * following Standard 062: Inference Worker Stability
+ */
+import * as v8 from 'v8';
+export interface MemoryStats {
+    rss: number;
+    heapTotal: number;
+    heapUsed: number;
+    external: number;
+    arrayBuffers: number;
+    percentageUsed: number;
+    heapSpaces: HeapSpaceInfo[];
+}
+export interface HeapSpaceInfo {
+    name: string;
+    size: number;
+    used: number;
+    available: number;
+    physical: number;
+}
+export interface ResourceLimits {
+    maxHeapSize: number;
+    memoryThreshold: number;
+    maxAtomsInMemory: number;
+    gcThreshold: number;
+}
+/**
+ * Interface for system resource access to facilitate testing
+ */
+export interface SystemResources {
+    getTotalMemory(): number;
+    getMemoryUsage(): NodeJS.MemoryUsage;
+    getHeapStatistics(): v8.HeapInfo;
+    getHeapSpaceStatistics(): v8.HeapSpaceInfo[];
+    gc(): void;
+    hasGc(): boolean;
+}
+export declare class ResourceManager {
+    private static instance;
+    private limits;
+    private lastGCTime;
+    private gcCooldown;
+    private resources;
+    private monitoringInterval;
+    private constructor();
+    static getInstance(): ResourceManager;
+    /**
+     * Reset the singleton instance (for testing only)
+     */
+    static resetInstance(): void;
+    /**
+     * Create an instance with specific resources (for testing only)
+     */
+    static createInstanceForTesting(resources: SystemResources): ResourceManager;
+    /**
+     * Get current memory statistics
+     */
+    getMemoryStats(): MemoryStats;
+    /**
+     * Get detailed heap space information
+     */
+    private getHeapSpaceInfo;
+    /**
+     * Check if memory usage is approaching limits
+     */
+    isMemoryCritical(): boolean;
+    /**
+     * Check if optimization is needed
+     */
+    needsOptimization(): boolean;
+    /**
+     * Perform garbage collection if needed and allowed
+     */
+    performGCIfNeeded(): void;
+    /**
+     * Force garbage collection (requires --expose-gc flag)
+     */
+    performGarbageCollection(): void;
+    /**
+     * Optimize memory usage by clearing caches and releasing unused resources
+     */
+    optimizeMemory(): void;
+    /**
+     * Clear internal caches to free up memory
+     */
+    private clearInternalCaches;
+    /**
+     * Get resource limits
+     */
+    getResourceLimits(): ResourceLimits;
+    /**
+     * Update resource limits
+     */
+    updateLimits(newLimits: Partial<ResourceLimits>): void;
+    /**
+     * Monitor memory usage and trigger optimizations
+     */
+    startMonitoring(intervalMs?: number): void;
+    /**
+     * Stop memory monitoring
+     */
+    stopMonitoring(): void;
+}
+export declare const resourceManager: ResourceManager;
+//# sourceMappingURL=resource-manager.d.ts.map

package/engine/dist/utils/resource-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-manager.d.ts","sourceRoot":"","sources":["../../src/utils/resource-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,IAAI,MAAM,CAAC;IACzB,cAAc,IAAI,MAAM,CAAC,WAAW,CAAC;IACrC,iBAAiB,IAAI,EAAE,CAAC,QAAQ,CAAC;IACjC,sBAAsB,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;IAC7C,EAAE,IAAI,IAAI,CAAC;IACX,KAAK,IAAI,OAAO,CAAC;CAClB;AAiCD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,kBAAkB,CAA+B;IAEzD,OAAO;WAaO,WAAW,IAAI,eAAe;IAO5C;;OAEG;WACW,aAAa,IAAI,IAAI;IAKnC;;OAEG;WACW,wBAAwB,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe;IAKnF;;OAEG;IACI,cAAc,IAAI,WAAW;IAgBpC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACI,gBAAgB,IAAI,OAAO;IAKlC;;OAEG;IACI,iBAAiB,IAAI,OAAO;IAKnC;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAchC;;OAEG;IACI,wBAAwB,IAAI,IAAI;IAgBvC;;OAEG;IACI,cAAc,IAAI,IAAI;IAc7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACI,iBAAiB,IAAI,cAAc;IAI1C;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAI7D;;OAEG;IACI,eAAe,CAAC,UAAU,GAAE,MAAsC,GAAG,IAAI;IAwBhF;;OAEG;IACI,cAAc,IAAI,IAAI;CAO9B;AAGD,eAAO,MAAM,eAAe,iBAAgC,CAAC"}