agent-ide 0.1.0

package/dist/core/performance/interfaces.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Performance 模組介面定義
+ * 定義效能分析的核心資料結構和介面
+ */
+/**
+ * 效能指標
+ */
+export interface PerformanceMetrics {
+    /** 執行時間（毫秒） */
+    duration: number;
+    /** 記憶體使用量（位元組） */
+    memoryUsage: number;
+    /** CPU 使用率（百分比） */
+    cpuUsage?: number;
+    /** 吞吐量（每秒操作數） */
+    throughput?: number;
+    /** 延遲（毫秒） */
+    latency?: number;
+}
+/**
+ * 檔案效能分析結果
+ */
+export interface FilePerformanceInfo {
+    /** 檔案路徑 */
+    filePath: string;
+    /** 檔案大小（位元組） */
+    fileSize: number;
+    /** 解析時間（毫秒） */
+    parseTime: number;
+    /** 函式數量 */
+    functionCount: number;
+    /** 類別數量 */
+    classCount: number;
+    /** 長函式數量 */
+    longFunctionCount: number;
+    /** 嵌套深度 */
+    nestingDepth: number;
+    /** 循環複雜度 */
+    cyclomaticComplexity: number;
+}
+/**
+ * 效能問題類型
+ */
+export declare enum PerformanceIssueType {
+    LARGE_FILE = "large_file",
+    LONG_FUNCTION = "long_function",
+    DEEP_NESTING = "deep_nesting",
+    HIGH_COMPLEXITY = "high_complexity",
+    NESTED_LOOPS = "nested_loops",
+    MEMORY_INTENSIVE = "memory_intensive"
+}
+/**
+ * 效能問題
+ */
+export interface PerformanceIssue {
+    /** 問題類型 */
+    type: PerformanceIssueType;
+    /** 嚴重程度 (1-10) */
+    severity: number;
+    /** 檔案路徑 */
+    filePath: string;
+    /** 位置資訊 */
+    location?: {
+        line: number;
+        column: number;
+    };
+    /** 問題描述 */
+    message: string;
+    /** 建議修復方案 */
+    suggestions: string[];
+    /** 指標值 */
+    value: number;
+    /** 閾值 */
+    threshold: number;
+}
+/**
+ * 效能分析配置
+ */
+export interface PerformanceAnalysisConfig {
+    /** 大檔案閾值（位元組） */
+    largeFileThreshold: number;
+    /** 長函式閾值（行數） */
+    longFunctionThreshold: number;
+    /** 深度嵌套閾值 */
+    deepNestingThreshold: number;
+    /** 高複雜度閾值 */
+    highComplexityThreshold: number;
+    /** 記憶體限制（位元組） */
+    memoryLimit?: number;
+    /** 是否啟用詳細模式 */
+    verbose: boolean;
+    /** 是否啟用快取 */
+    enableCache: boolean;
+}
+/**
+ * 效能分析結果
+ */
+export interface PerformanceAnalysisResult {
+    /** 分析指標 */
+    metrics: PerformanceMetrics;
+    /** 檔案分析結果 */
+    fileResults: FilePerformanceInfo[];
+    /** 發現的問題 */
+    issues: PerformanceIssue[];
+    /** 總結統計 */
+    summary: {
+        totalFiles: number;
+        totalSize: number;
+        averageFileSize: number;
+        largeFileCount: number;
+        longFunctionCount: number;
+        highComplexityCount: number;
+        overallScore: number;
+    };
+    /** 建議 */
+    recommendations: string[];
+}
+/**
+ * 記憶體快照
+ */
+export interface MemorySnapshot {
+    /** 快照時間 */
+    timestamp: Date;
+    /** 堆記憶體使用量 */
+    heapUsed: number;
+    /** 堆記憶體總量 */
+    heapTotal: number;
+    /** 常駐集記憶體 */
+    rss: number;
+    /** 外部記憶體 */
+    external: number;
+    /** 陣列緩衝區 */
+    arrayBuffers: number;
+}
+/**
+ * 快取統計
+ */
+export interface CacheStatistics {
+    /** 快取命中次數 */
+    hits: number;
+    /** 快取未命中次數 */
+    misses: number;
+    /** 快取命中率 */
+    hitRate: number;
+    /** 快取大小 */
+    size: number;
+    /** 快取項目數 */
+    itemCount: number;
+}
+/**
+ * 效能監控器介面
+ */
+export interface PerformanceMonitor {
+    /**
+     * 開始監控
+     */
+    start(): void;
+    /**
+     * 停止監控
+     */
+    stop(): PerformanceMetrics;
+    /**
+     * 記錄記憶體快照
+     */
+    recordMemorySnapshot(): MemorySnapshot;
+    /**
+     * 獲取當前指標
+     */
+    getCurrentMetrics(): PerformanceMetrics;
+}
+/**
+ * 效能分析器介面
+ */
+export interface PerformanceAnalyzer {
+    /**
+     * 分析檔案效能
+     */
+    analyzeFile(filePath: string, config?: PerformanceAnalysisConfig): Promise<FilePerformanceInfo>;
+    /**
+     * 分析專案效能
+     */
+    analyzeProject(projectPath: string, config?: PerformanceAnalysisConfig): Promise<PerformanceAnalysisResult>;
+    /**
+     * 檢測效能問題
+     */
+    detectIssues(fileInfo: FilePerformanceInfo, config: PerformanceAnalysisConfig): PerformanceIssue[];
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/core/performance/interfaces.d.ts.map

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

package/dist/core/performance/interfaces.js

@@ -0,0 +1,17 @@
+/**
+ * Performance 模組介面定義
+ * 定義效能分析的核心資料結構和介面
+ */
+/**
+ * 效能問題類型
+ */
+export var PerformanceIssueType;
+(function (PerformanceIssueType) {
+    PerformanceIssueType["LARGE_FILE"] = "large_file";
+    PerformanceIssueType["LONG_FUNCTION"] = "long_function";
+    PerformanceIssueType["DEEP_NESTING"] = "deep_nesting";
+    PerformanceIssueType["HIGH_COMPLEXITY"] = "high_complexity";
+    PerformanceIssueType["NESTED_LOOPS"] = "nested_loops";
+    PerformanceIssueType["MEMORY_INTENSIVE"] = "memory_intensive";
+})(PerformanceIssueType || (PerformanceIssueType = {}));
+//# sourceMappingURL=interfaces.js.map

package/dist/core/performance/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/core/performance/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwCH;;GAEG;AACH,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,iDAAyB,CAAA;IACzB,uDAA+B,CAAA;IAC/B,qDAA6B,CAAA;IAC7B,2DAAmC,CAAA;IACnC,qDAA6B,CAAA;IAC7B,6DAAqC,CAAA;AACvC,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B"}

package/dist/core/performance/memory-manager.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Performance Memory Manager
+ * 提供記憶體監控、管理和優化功能
+ */
+import { MemorySnapshot } from './interfaces.js';
+/**
+ * 記憶體閾值配置
+ */
+export interface MemoryThresholds {
+    /** 警告閾值（位元組） */
+    warning: number;
+    /** 錯誤閾值（位元組） */
+    error: number;
+    /** 最大堆大小（位元組） */
+    maxHeapSize?: number;
+    /** GC 觸發閾值（位元組） */
+    gcThreshold?: number;
+}
+/**
+ * 記憶體使用統計
+ */
+export interface MemoryUsageStats {
+    /** 當前記憶體使用 */
+    current: MemorySnapshot;
+    /** 峰值記憶體使用 */
+    peak: MemorySnapshot;
+    /** 平均記憶體使用 */
+    average: MemorySnapshot;
+    /** GC 次數 */
+    gcCount: number;
+    /** 記憶體洩漏檢測結果 */
+    leakDetection: {
+        suspected: boolean;
+        growthRate: number;
+        stableTime: number;
+    };
+}
+/**
+ * 記憶體管理配置
+ */
+export interface MemoryManagerConfig {
+    /** 記憶體閾值 */
+    thresholds: MemoryThresholds;
+    /** 監控間隔（毫秒） */
+    monitoringInterval: number;
+    /** 快照保留數量 */
+    maxSnapshots: number;
+    /** 自動 GC */
+    autoGc: boolean;
+    /** 洩漏檢測 */
+    leakDetection: boolean;
+    /** 記憶體限制 */
+    memoryLimit?: number;
+}
+/**
+ * 預設記憶體管理配置
+ */
+export declare const DEFAULT_MEMORY_CONFIG: MemoryManagerConfig;
+/**
+ * 記憶體事件類型
+ */
+export declare enum MemoryEventType {
+    WARNING = "warning",
+    ERROR = "error",
+    GC_TRIGGERED = "gc_triggered",
+    LEAK_DETECTED = "leak_detected",
+    LIMIT_EXCEEDED = "limit_exceeded"
+}
+/**
+ * 記憶體事件
+ */
+export interface MemoryEvent {
+    type: MemoryEventType;
+    timestamp: Date;
+    snapshot: MemorySnapshot;
+    message: string;
+    data?: any;
+}
+/**
+ * 記憶體事件監聽器
+ */
+export type MemoryEventListener = (event: MemoryEvent) => void;
+/**
+ * 效能記憶體管理器
+ */
+export declare class PerformanceMemoryManager {
+    private config;
+    private snapshots;
+    private listeners;
+    private monitoringTimer?;
+    private isMonitoring;
+    private gcCount;
+    private peakSnapshot?;
+    constructor(config?: Partial<MemoryManagerConfig>);
+    /**
+     * 開始記憶體監控
+     */
+    startMonitoring(): void;
+    /**
+     * 停止記憶體監控
+     */
+    stopMonitoring(): void;
+    /**
+     * 記錄記憶體快照
+     */
+    recordSnapshot(): MemorySnapshot;
+    /**
+     * 獲取當前記憶體快照
+     */
+    getCurrentSnapshot(): MemorySnapshot;
+    /**
+     * 獲取記憶體使用統計
+     */
+    getUsageStats(): MemoryUsageStats;
+    /**
+     * 檢查記憶體使用量
+     */
+    private checkMemoryUsage;
+    /**
+     * 觸發垃圾回收
+     */
+    triggerGarbageCollection(): boolean;
+    /**
+     * 檢測記憶體洩漏
+     */
+    private detectMemoryLeak;
+    /**
+     * 計算記憶體穩定時間
+     */
+    private calculateStableTime;
+    /**
+     * 計算變異數
+     */
+    private calculateVariance;
+    /**
+     * 計算平均記憶體快照
+     */
+    private calculateAverageSnapshot;
+    /**
+     * 註冊事件監聽器
+     */
+    on(eventType: MemoryEventType, listener: MemoryEventListener): void;
+    /**
+     * 移除事件監聽器
+     */
+    off(eventType: MemoryEventType, listener: MemoryEventListener): void;
+    /**
+     * 發送事件
+     */
+    private emitEvent;
+    /**
+     * 獲取記憶體快照歷史
+     */
+    getSnapshots(): MemorySnapshot[];
+    /**
+     * 清理快照歷史
+     */
+    clearSnapshots(): void;
+    /**
+     * 格式化位元組數
+     */
+    private formatBytes;
+    /**
+     * 獲取記憶體使用建議
+     */
+    getOptimizationSuggestions(): string[];
+    /**
+     * 清理資源
+     */
+    dispose(): void;
+}
+/**
+ * 全域記憶體管理器實例
+ */
+export declare const globalMemoryManager: PerformanceMemoryManager;
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/core/performance/memory-manager.d.ts.map

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