dartmind 17.0.0

package/dist/indexer/CpuMonitor.d.ts

@@ -0,0 +1,119 @@
+/**
+ * DartMind V17 - CPU Monitor
+ * Day 2: System resource tracking for GR3 Yield-Priority Indexer
+ *
+ * Monitors CPU usage and provides throttling recommendations.
+ *
+ * @module indexer/CpuMonitor
+ * @version 17.0.0
+ */
+import { EventEmitter } from 'events';
+export interface CpuUsage {
+    /** Overall CPU usage percentage (0-100) */
+    overall: number;
+    /** Per-core CPU usage */
+    perCore: number[];
+    /** User CPU time percentage */
+    user: number;
+    /** System CPU time percentage */
+    system: number;
+    /** Idle percentage */
+    idle: number;
+}
+export interface MemoryUsage {
+    /** Total system memory in MB */
+    totalMB: number;
+    /** Used memory in MB */
+    usedMB: number;
+    /** Free memory in MB */
+    freeMB: number;
+    /** Memory usage percentage (0-100) */
+    usagePercent: number;
+    /** Process heap used in MB */
+    processHeapMB: number;
+    /** Process RSS in MB */
+    processRssMB: number;
+}
+export interface SystemMetrics {
+    cpu: CpuUsage;
+    memory: MemoryUsage;
+    loadAverage: number[];
+    timestamp: number;
+}
+export type ThrottleLevel = 'none' | 'light' | 'moderate' | 'heavy' | 'pause';
+export interface ThrottleRecommendation {
+    level: ThrottleLevel;
+    yieldEveryNFiles: number;
+    yieldDurationMs: number;
+    reason: string;
+    cpuUsage: number;
+    memoryUsage: number;
+}
+export interface CpuMonitorConfig {
+    /** Polling interval in ms (default: 1000) */
+    pollingIntervalMs?: number;
+    /** CPU threshold for light throttle (default: 50) */
+    lightThreshold?: number;
+    /** CPU threshold for moderate throttle (default: 70) */
+    moderateThreshold?: number;
+    /** CPU threshold for heavy throttle (default: 85) */
+    heavyThreshold?: number;
+    /** CPU threshold for pause (default: 95) */
+    pauseThreshold?: number;
+    /** CPU threshold to resume from pause (default: 60) */
+    resumeThreshold?: number;
+    /** Memory pressure threshold percentage (default: 90) */
+    memoryPressureThreshold?: number;
+}
+export declare class CpuMonitor extends EventEmitter {
+    private config;
+    private pollingTimer;
+    private previousCpuInfo;
+    private metricsHistory;
+    private readonly maxHistorySize;
+    private isPaused;
+    constructor(config?: CpuMonitorConfig);
+    /**
+     * Start monitoring system resources
+     */
+    start(): void;
+    /**
+     * Stop monitoring
+     */
+    stop(): void;
+    /**
+     * Get current system metrics
+     */
+    collectMetrics(): SystemMetrics;
+    /**
+     * Get CPU usage information
+     */
+    getCpuUsage(): CpuUsage;
+    /**
+     * Get memory usage information
+     */
+    getMemoryUsage(): MemoryUsage;
+    /**
+     * Get throttle recommendation based on current metrics
+     */
+    getThrottleRecommendation(): ThrottleRecommendation;
+    /**
+     * Get average CPU usage over the last N seconds
+     */
+    getAverageCpu(seconds: number): number;
+    /**
+     * Check if system is under pressure
+     */
+    isUnderPressure(): boolean;
+    /**
+     * Get metrics history
+     */
+    getHistory(): SystemMetrics[];
+    /**
+     * Clear metrics history
+     */
+    clearHistory(): void;
+}
+export declare function createCpuMonitor(config?: CpuMonitorConfig): CpuMonitor;
+export default CpuMonitor;
+//# sourceMappingURL=CpuMonitor.d.ts.map

package/dist/indexer/CpuMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CpuMonitor.d.ts","sourceRoot":"","sources":["../../src/indexer/CpuMonitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,QAAQ,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,aAAa,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAMD,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;IACrC,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,GAAE,gBAAqB;IAazC;;OAEG;IACH,KAAK,IAAI,IAAI;IAiCb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,cAAc,IAAI,aAAa;IAS/B;;OAEG;IACH,WAAW,IAAI,QAAQ;IAyCvB;;OAEG;IACH,cAAc,IAAI,WAAW;IAgB7B;;OAEG;IACH,yBAAyB,IAAI,sBAAsB;IA2EnD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAStC;;OAEG;IACH,eAAe,IAAI,OAAO;IAK1B;;OAEG;IACH,UAAU,IAAI,aAAa,EAAE;IAI7B;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAEtE;AAED,eAAe,UAAU,CAAC"}

package/dist/indexer/CpuMonitor.js

@@ -0,0 +1,246 @@
+/**
+ * DartMind V17 - CPU Monitor
+ * Day 2: System resource tracking for GR3 Yield-Priority Indexer
+ *
+ * Monitors CPU usage and provides throttling recommendations.
+ *
+ * @module indexer/CpuMonitor
+ * @version 17.0.0
+ */
+import * as os from 'os';
+import { EventEmitter } from 'events';
+// ============================================================================
+// CPU Monitor Class
+// ============================================================================
+export class CpuMonitor extends EventEmitter {
+    config;
+    pollingTimer = null;
+    previousCpuInfo = null;
+    metricsHistory = [];
+    maxHistorySize = 60; // Keep 1 minute of history
+    isPaused = false;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            pollingIntervalMs: config.pollingIntervalMs ?? 1000,
+            lightThreshold: config.lightThreshold ?? 50,
+            moderateThreshold: config.moderateThreshold ?? 70,
+            heavyThreshold: config.heavyThreshold ?? 85,
+            pauseThreshold: config.pauseThreshold ?? 95,
+            resumeThreshold: config.resumeThreshold ?? 60,
+            memoryPressureThreshold: config.memoryPressureThreshold ?? 90,
+        };
+    }
+    /**
+     * Start monitoring system resources
+     */
+    start() {
+        if (this.pollingTimer)
+            return;
+        // Initialize previous CPU info
+        this.previousCpuInfo = os.cpus();
+        this.pollingTimer = setInterval(() => {
+            const metrics = this.collectMetrics();
+            this.metricsHistory.push(metrics);
+            // Trim history
+            if (this.metricsHistory.length > this.maxHistorySize) {
+                this.metricsHistory.shift();
+            }
+            // Emit metrics
+            this.emit('metrics', metrics);
+            // Check throttle recommendation
+            const recommendation = this.getThrottleRecommendation();
+            this.emit('throttle', recommendation);
+            // Handle pause/resume transitions
+            if (recommendation.level === 'pause' && !this.isPaused) {
+                this.isPaused = true;
+                this.emit('pause', { reason: recommendation.reason, metrics });
+            }
+            else if (this.isPaused && metrics.cpu.overall < this.config.resumeThreshold) {
+                this.isPaused = false;
+                this.emit('resume', { metrics });
+            }
+        }, this.config.pollingIntervalMs);
+    }
+    /**
+     * Stop monitoring
+     */
+    stop() {
+        if (this.pollingTimer) {
+            clearInterval(this.pollingTimer);
+            this.pollingTimer = null;
+        }
+    }
+    /**
+     * Get current system metrics
+     */
+    collectMetrics() {
+        return {
+            cpu: this.getCpuUsage(),
+            memory: this.getMemoryUsage(),
+            loadAverage: os.loadavg(),
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Get CPU usage information
+     */
+    getCpuUsage() {
+        const cpus = os.cpus();
+        const perCore = [];
+        let totalUser = 0;
+        let totalSystem = 0;
+        let totalIdle = 0;
+        let totalTick = 0;
+        cpus.forEach((cpu, i) => {
+            const prevCpu = this.previousCpuInfo?.[i];
+            const user = cpu.times.user - (prevCpu?.times.user ?? 0);
+            const nice = cpu.times.nice - (prevCpu?.times.nice ?? 0);
+            const sys = cpu.times.sys - (prevCpu?.times.sys ?? 0);
+            const idle = cpu.times.idle - (prevCpu?.times.idle ?? 0);
+            const irq = cpu.times.irq - (prevCpu?.times.irq ?? 0);
+            const total = user + nice + sys + idle + irq;
+            const usage = total > 0 ? ((total - idle) / total) * 100 : 0;
+            perCore.push(Math.round(usage * 10) / 10);
+            totalUser += user;
+            totalSystem += sys;
+            totalIdle += idle;
+            totalTick += total;
+        });
+        // Update previous for next calculation
+        this.previousCpuInfo = cpus;
+        const overall = totalTick > 0 ? ((totalTick - totalIdle) / totalTick) * 100 : 0;
+        return {
+            overall: Math.round(overall * 10) / 10,
+            perCore,
+            user: totalTick > 0 ? Math.round((totalUser / totalTick) * 1000) / 10 : 0,
+            system: totalTick > 0 ? Math.round((totalSystem / totalTick) * 1000) / 10 : 0,
+            idle: totalTick > 0 ? Math.round((totalIdle / totalTick) * 1000) / 10 : 0,
+        };
+    }
+    /**
+     * Get memory usage information
+     */
+    getMemoryUsage() {
+        const totalMem = os.totalmem();
+        const freeMem = os.freemem();
+        const usedMem = totalMem - freeMem;
+        const processMemory = process.memoryUsage();
+        return {
+            totalMB: Math.round(totalMem / 1024 / 1024),
+            usedMB: Math.round(usedMem / 1024 / 1024),
+            freeMB: Math.round(freeMem / 1024 / 1024),
+            usagePercent: Math.round((usedMem / totalMem) * 1000) / 10,
+            processHeapMB: Math.round(processMemory.heapUsed / 1024 / 1024),
+            processRssMB: Math.round(processMemory.rss / 1024 / 1024),
+        };
+    }
+    /**
+     * Get throttle recommendation based on current metrics
+     */
+    getThrottleRecommendation() {
+        const metrics = this.metricsHistory.length > 0
+            ? this.metricsHistory[this.metricsHistory.length - 1]
+            : this.collectMetrics();
+        const cpu = metrics.cpu.overall;
+        const memory = metrics.memory.usagePercent;
+        // Check memory pressure first
+        if (memory >= this.config.memoryPressureThreshold) {
+            return {
+                level: 'pause',
+                yieldEveryNFiles: 1,
+                yieldDurationMs: 1000,
+                reason: `Memory pressure: ${memory}% used`,
+                cpuUsage: cpu,
+                memoryUsage: memory,
+            };
+        }
+        // Check CPU thresholds (GR3 specification)
+        if (cpu >= this.config.pauseThreshold) {
+            return {
+                level: 'pause',
+                yieldEveryNFiles: 1,
+                yieldDurationMs: 1000,
+                reason: `CPU critical: ${cpu}% - PAUSE until < ${this.config.resumeThreshold}%`,
+                cpuUsage: cpu,
+                memoryUsage: memory,
+            };
+        }
+        if (cpu >= this.config.heavyThreshold) {
+            return {
+                level: 'heavy',
+                yieldEveryNFiles: 1,
+                yieldDurationMs: 500,
+                reason: `CPU high: ${cpu}% - yield every file (500ms)`,
+                cpuUsage: cpu,
+                memoryUsage: memory,
+            };
+        }
+        if (cpu >= this.config.moderateThreshold) {
+            return {
+                level: 'moderate',
+                yieldEveryNFiles: 5,
+                yieldDurationMs: 100,
+                reason: `CPU moderate: ${cpu}% - yield every 5 files (100ms)`,
+                cpuUsage: cpu,
+                memoryUsage: memory,
+            };
+        }
+        if (cpu >= this.config.lightThreshold) {
+            return {
+                level: 'light',
+                yieldEveryNFiles: 10,
+                yieldDurationMs: 50,
+                reason: `CPU elevated: ${cpu}% - yield every 10 files (50ms)`,
+                cpuUsage: cpu,
+                memoryUsage: memory,
+            };
+        }
+        return {
+            level: 'none',
+            yieldEveryNFiles: 0,
+            yieldDurationMs: 0,
+            reason: `CPU normal: ${cpu}% - full speed`,
+            cpuUsage: cpu,
+            memoryUsage: memory,
+        };
+    }
+    /**
+     * Get average CPU usage over the last N seconds
+     */
+    getAverageCpu(seconds) {
+        const samples = Math.min(seconds, this.metricsHistory.length);
+        if (samples === 0)
+            return this.getCpuUsage().overall;
+        const recentMetrics = this.metricsHistory.slice(-samples);
+        const sum = recentMetrics.reduce((acc, m) => acc + m.cpu.overall, 0);
+        return Math.round((sum / samples) * 10) / 10;
+    }
+    /**
+     * Check if system is under pressure
+     */
+    isUnderPressure() {
+        const recommendation = this.getThrottleRecommendation();
+        return recommendation.level === 'pause' || recommendation.level === 'heavy';
+    }
+    /**
+     * Get metrics history
+     */
+    getHistory() {
+        return [...this.metricsHistory];
+    }
+    /**
+     * Clear metrics history
+     */
+    clearHistory() {
+        this.metricsHistory = [];
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createCpuMonitor(config) {
+    return new CpuMonitor(config);
+}
+export default CpuMonitor;
+//# sourceMappingURL=CpuMonitor.js.map

package/dist/indexer/CpuMonitor.js.map

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

package/dist/indexer/DiffAnalyzer.d.ts

@@ -0,0 +1,117 @@
+/**
+ * DartMind V17 - Diff Analyzer
+ * Day 9: Semantic Diff Engine (M3)
+ *
+ * Analyzes diffs to extract semantic changes:
+ * - Parses unified diff format
+ * - Extracts symbol-level changes
+ * - Identifies patterns in changes
+ *
+ * @module indexer/DiffAnalyzer
+ * @version 17.0.0
+ */
+import { EventEmitter } from 'events';
+import type { Diff, FileDiff, DiffHunk, CommitInfo, SemanticChange, SemanticDiffConfig, SemanticDiffEventHandler } from './SemanticDiffTypes.js';
+/**
+ * Parses unified diff format into structured data
+ */
+export declare class DiffParser {
+    /**
+     * Parse a unified diff string into a Diff object
+     */
+    parse(diffText: string, commitInfo?: CommitInfo): Diff;
+    /**
+     * Initialize a new FileDiff
+     */
+    private initializeFileDiff;
+}
+/**
+ * Analyzes diffs to extract semantic changes
+ */
+export declare class DiffAnalyzer extends EventEmitter {
+    private readonly config;
+    private readonly parser;
+    private readonly eventHandlers;
+    constructor(config?: Partial<SemanticDiffConfig>);
+    /**
+     * Register an event handler
+     */
+    onEvent(handler: SemanticDiffEventHandler): () => void;
+    /**
+     * Emit an event
+     */
+    private emitEvent;
+    /**
+     * Parse a diff string
+     */
+    parseDiff(diffText: string, commitInfo?: CommitInfo): Diff;
+    /**
+     * Analyze a file diff for semantic changes
+     */
+    analyzeFileDiff(fileDiff: FileDiff): SemanticChange[];
+    /**
+     * Analyze a single hunk for semantic changes
+     */
+    analyzeHunk(hunk: DiffHunk, filePath: string): SemanticChange[];
+    /**
+     * Detect symbol-level changes (classes, functions, methods)
+     */
+    private detectSymbolChanges;
+    /**
+     * Detect function/method signature changes
+     */
+    private detectSignatureChanges;
+    /**
+     * Analyze parameter changes
+     */
+    private analyzeParameterChange;
+    /**
+     * Parse parameter string into structured list
+     */
+    private parseParameters;
+    /**
+     * Detect import/export changes
+     */
+    private detectImportChanges;
+    /**
+     * Detect documentation changes
+     */
+    private detectDocumentationChanges;
+    /**
+     * Detect annotation/decorator changes
+     */
+    private detectAnnotationChanges;
+    /**
+     * Find a similar symbol name (for rename detection)
+     */
+    private findSimilarSymbol;
+    /**
+     * Calculate similarity between two strings (0-100)
+     */
+    private calculateSimilarity;
+    /**
+     * Check if file should be analyzed
+     */
+    private shouldAnalyzeFile;
+    /**
+     * Simple glob matching
+     */
+    private matchGlob;
+    /**
+     * Create a semantic change
+     */
+    private createChange;
+    /**
+     * Get configuration
+     */
+    getConfig(): Readonly<SemanticDiffConfig>;
+}
+/**
+ * Create a diff parser
+ */
+export declare function createDiffParser(): DiffParser;
+/**
+ * Create a diff analyzer
+ */
+export declare function createDiffAnalyzer(config?: Partial<SemanticDiffConfig>): DiffAnalyzer;
+//# sourceMappingURL=DiffAnalyzer.d.ts.map

package/dist/indexer/DiffAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiffAnalyzer.d.ts","sourceRoot":"","sources":["../../src/indexer/DiffAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,QAAQ,EAER,UAAU,EACV,cAAc,EAGd,kBAAkB,EAElB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAahC;;GAEG;AACH,qBAAa,UAAU;IACrB;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IA+ItD;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAW3B;AAMD;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;gBAE9D,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAMpD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,IAAI;IAKtD;;OAEG;IACH,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IAI1D;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,EAAE;IA2CrD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAwB/D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoG3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoE9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0E9B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4D3B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAkDlC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgD/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkCpB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,kBAAkB,CAAC;CAG1C;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,YAAY,CAEd"}