agent-ide 0.1.0

package/dist/infrastructure/cache/cache-manager.js

@@ -0,0 +1,279 @@
+import { MemoryCache } from './memory-cache.js';
+/**
+ * 快取管理器 - 管理多個快取實例
+ */
+export class CacheManager {
+    caches = new Map();
+    options;
+    globalEventListeners = new Set();
+    disposed = false;
+    constructor(options = {}) {
+        this.options = {
+            defaultCacheOptions: options.defaultCacheOptions || {},
+            enableGlobalStats: options.enableGlobalStats ?? false,
+            warmupConfig: {
+                enabled: false,
+                strategy: 'lazy',
+                ...options.warmupConfig
+            },
+            persistenceConfig: {
+                enabled: false,
+                interval: 60000,
+                compression: false,
+                backup: {
+                    enabled: false,
+                    maxBackups: 3
+                },
+                ...options.persistenceConfig
+            }
+        };
+    }
+    /**
+     * 建立新的快取實例
+     */
+    createCache(name, options) {
+        this.checkDisposed();
+        if (this.caches.has(name)) {
+            throw new Error(`Cache with name "${name}" already exists`);
+        }
+        // 合併預設配置和自訂配置
+        const mergedOptions = {
+            ...this.options.defaultCacheOptions,
+            ...options
+        };
+        const cache = new MemoryCache(mergedOptions);
+        // 如果啟用全域統計，添加事件監聽器
+        if (this.options.enableGlobalStats) {
+            cache.addListener(this.handleCacheEvent.bind(this));
+        }
+        this.caches.set(name, cache);
+        return cache;
+    }
+    /**
+     * 取得現有的快取實例
+     */
+    getCache(name) {
+        this.checkDisposed();
+        return this.caches.get(name);
+    }
+    /**
+     * 檢查快取是否存在
+     */
+    hasCache(name) {
+        this.checkDisposed();
+        return this.caches.has(name);
+    }
+    /**
+     * 刪除快取實例
+     */
+    deleteCache(name) {
+        this.checkDisposed();
+        const cache = this.caches.get(name);
+        if (!cache) {
+            return false;
+        }
+        cache.dispose();
+        this.caches.delete(name);
+        return true;
+    }
+    /**
+     * 批次刪除快取實例
+     */
+    deleteCaches(names) {
+        this.checkDisposed();
+        const successful = [];
+        const failed = [];
+        for (const name of names) {
+            if (this.deleteCache(name)) {
+                successful.push(name);
+            }
+            else {
+                failed.push(name);
+            }
+        }
+        return { successful, failed };
+    }
+    /**
+     * 列出所有快取名稱
+     */
+    listCaches() {
+        this.checkDisposed();
+        return Array.from(this.caches.keys());
+    }
+    /**
+     * 清空指定快取的內容
+     */
+    clearCache(name) {
+        this.checkDisposed();
+        const cache = this.caches.get(name);
+        if (!cache) {
+            return false;
+        }
+        cache.clear();
+        return true;
+    }
+    /**
+     * 批次清空多個快取的內容
+     */
+    clearCaches(names) {
+        this.checkDisposed();
+        for (const name of names) {
+            this.clearCache(name);
+        }
+    }
+    /**
+     * 清空所有快取的內容
+     */
+    clearAll() {
+        this.checkDisposed();
+        for (const cache of this.caches.values()) {
+            cache.clear();
+        }
+    }
+    /**
+     * 預熱快取
+     */
+    async warmupCache(name) {
+        this.checkDisposed();
+        if (!this.options.warmupConfig.enabled) {
+            throw new Error('Cache warmup is disabled');
+        }
+        const cache = this.caches.get(name);
+        if (!cache) {
+            throw new Error(`Cache with name "${name}" does not exist`);
+        }
+        const config = this.options.warmupConfig;
+        let loaded = 0;
+        let failed = 0;
+        try {
+            if (config.dataSource) {
+                const data = await config.dataSource();
+                for (const [key, value] of data.entries()) {
+                    try {
+                        cache.set(key, value);
+                        loaded++;
+                    }
+                    catch (error) {
+                        failed++;
+                        console.warn(`Failed to warm up cache item ${key}:`, error);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            failed++;
+            console.error('Failed to load warmup data:', error);
+        }
+        // 呼叫完成回調
+        if (config.onComplete) {
+            config.onComplete({ loaded, failed });
+        }
+    }
+    /**
+     * 取得全域統計資訊
+     */
+    getGlobalStats() {
+        this.checkDisposed();
+        if (!this.options.enableGlobalStats) {
+            return {
+                totalCaches: 0,
+                totalItems: 0,
+                totalRequests: 0,
+                totalHits: 0,
+                totalMisses: 0,
+                globalHitRate: 0,
+                totalMemoryUsage: 0,
+                totalEvictions: 0,
+                totalExpirations: 0
+            };
+        }
+        let totalItems = 0;
+        let totalRequests = 0;
+        let totalHits = 0;
+        let totalMisses = 0;
+        let totalMemoryUsage = 0;
+        let totalEvictions = 0;
+        let totalExpirations = 0;
+        for (const cache of this.caches.values()) {
+            const stats = cache.getStats();
+            totalItems += stats.size;
+            totalRequests += stats.totalRequests;
+            totalHits += stats.hits;
+            totalMisses += stats.misses;
+            totalMemoryUsage += stats.memoryUsage;
+            totalEvictions += stats.evictions;
+            totalExpirations += stats.expirations;
+        }
+        const globalHitRate = totalRequests > 0 ? totalHits / totalRequests : 0;
+        return {
+            totalCaches: this.caches.size,
+            totalItems,
+            totalRequests,
+            totalHits,
+            totalMisses,
+            globalHitRate,
+            totalMemoryUsage,
+            totalEvictions,
+            totalExpirations
+        };
+    }
+    /**
+     * 添加全域事件監聽器
+     */
+    addGlobalEventListener(listener) {
+        this.checkDisposed();
+        this.globalEventListeners.add(listener);
+    }
+    /**
+     * 移除全域事件監聽器
+     */
+    removeGlobalEventListener(listener) {
+        this.checkDisposed();
+        this.globalEventListeners.delete(listener);
+    }
+    /**
+     * 銷毀管理器和所有快取
+     */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        // 銷毀所有快取實例
+        for (const cache of this.caches.values()) {
+            cache.dispose();
+        }
+        this.caches.clear();
+        this.globalEventListeners.clear();
+        this.disposed = true;
+    }
+    /**
+     * 取得管理器配置
+     */
+    getOptions() {
+        return { ...this.options };
+    }
+    // ===== 私有方法 =====
+    /**
+     * 檢查管理器是否已被銷毀
+     */
+    checkDisposed() {
+        if (this.disposed) {
+            throw new Error('CacheManager has been disposed');
+        }
+    }
+    /**
+     * 處理快取事件（用於全域統計和事件轉發）
+     */
+    handleCacheEvent(event) {
+        // 轉發事件給所有全域監聽器
+        for (const listener of this.globalEventListeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('Global cache event listener error:', error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=cache-manager.js.map

package/dist/infrastructure/cache/cache-manager.js.map

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

package/dist/infrastructure/cache/index.d.ts

@@ -0,0 +1,138 @@
+/**
+ * 快取系統統一匯出
+ *
+ * 這個模組提供了完整的快取管理功能，包括：
+ * - MemoryCache: 高效能記憶體快取實作
+ * - CacheManager: 快取實例管理器
+ * - 多種淘汰策略支援 (LRU, LFU, FIFO, TTL, Random)
+ * - 統計追蹤和事件監聽
+ * - 批次操作支援
+ * - 快取預熱功能
+ */
+export { MemoryCache } from './memory-cache.js';
+export { CacheManager, type GlobalStats, type BatchOperationResult } from './cache-manager.js';
+export { LRUStrategy, LFUStrategy, FIFOStrategy, TTLStrategy, RandomStrategy, StrategyFactory, type CacheStrategy } from './strategies.js';
+export { type CacheItem, type CacheOptions, type CacheStats, type CacheEvent, type CacheEventListener, type CacheManagerOptions, type WarmupConfig, type PersistenceConfig, type BatchResult, type CacheQueryOptions, type CacheEntry, type SerializableValue, type SerializableObject, type SerializableArray, EvictionStrategy, CacheEventType } from './types.js';
+export declare const DEFAULT_CACHE_OPTIONS: {
+    maxSize: number;
+    maxMemory: number;
+    defaultTTL: number;
+    evictionStrategy: string;
+    enableStats: boolean;
+    cleanupInterval: number;
+};
+export declare const DEFAULT_MANAGER_OPTIONS: {
+    enableGlobalStats: boolean;
+    warmupConfig: {
+        enabled: boolean;
+        strategy: string;
+    };
+    persistenceConfig: {
+        enabled: boolean;
+        interval: number;
+        compression: boolean;
+        backup: {
+            enabled: boolean;
+            maxBackups: number;
+        };
+    };
+};
+/**
+ * 工廠函式：建立預設配置的 MemoryCache
+ */
+export declare function createMemoryCache<K, V>(options?: any): any;
+/**
+ * 工廠函式：建立預設配置的 CacheManager
+ */
+export declare function createCacheManager(options?: any): any;
+/**
+ * 工廠函式：建立 LRU 快取
+ */
+export declare function createLRUCache<K, V>(maxSize?: number): any;
+/**
+ * 工廠函式：建立帶 TTL 的快取
+ */
+export declare function createTTLCache<K, V>(defaultTTL: number, maxSize?: number): any;
+/**
+ * 工廠函式：建立高效能快取（針對高頻存取優化）
+ */
+export declare function createHighPerformanceCache<K, V>(options?: {
+    maxSize?: number;
+    strategy?: any;
+}): any;
+/**
+ * 快取工具函式
+ */
+export declare class CacheUtils {
+    /**
+     * 計算快取命中率
+     */
+    static calculateHitRate(hits: number, misses: number): number;
+    /**
+     * 格式化記憶體大小
+     */
+    static formatMemorySize(bytes: number): string;
+    /**
+     * 合併多個快取統計
+     */
+    static mergeStats(statsArray: any[]): any;
+    /**
+     * 產生快取鍵的雜湊值
+     */
+    static hashKey(key: any): string;
+    /**
+     * 驗證快取配置的合理性
+     */
+    static validateCacheOptions(options: any): string[];
+}
+/**
+ * 快取效能監控器
+ */
+export declare class CacheMonitor {
+    private readonly caches;
+    constructor(_manager?: any);
+    /**
+     * 監控單一快取
+     */
+    addCache(name: string, cache: any): void;
+    /**
+     * 移除監控的快取
+     */
+    removeCache(name: string): void;
+    /**
+     * 取得效能報告
+     */
+    getPerformanceReport(): {
+        caches: Array<{
+            name: string;
+            stats: any;
+            healthScore: number;
+        }>;
+        overall: {
+            totalCaches: number;
+            averageHitRate: number;
+            totalMemoryUsage: number;
+            healthScore: number;
+        };
+    };
+    /**
+     * 計算快取健康評分（0-100）
+     */
+    private calculateHealthScore;
+}
+/**
+ * 版本資訊
+ */
+export declare const VERSION = "1.0.0";
+/**
+ * 快取系統資訊
+ */
+export declare const CACHE_SYSTEM_INFO: {
+    readonly name: "Agent IDE Cache System";
+    readonly version: "1.0.0";
+    readonly description: "高效能快取管理系統，支援多種淘汰策略和統計追蹤";
+    readonly author: "Agent IDE Team";
+    readonly supportedStrategies: readonly ["lru", "lfu", "fifo", "ttl", "random"];
+    readonly features: readonly ["多種淘汰策略 (LRU, LFU, FIFO, TTL, Random)", "記憶體管理和限制", "統計追蹤和效能監控", "事件系統", "批次操作", "快取預熱", "並發安全"];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/cache/index.d.ts.map

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

package/dist/infrastructure/cache/index.js

@@ -0,0 +1,266 @@
+/**
+ * 快取系統統一匯出
+ *
+ * 這個模組提供了完整的快取管理功能，包括：
+ * - MemoryCache: 高效能記憶體快取實作
+ * - CacheManager: 快取實例管理器
+ * - 多種淘汰策略支援 (LRU, LFU, FIFO, TTL, Random)
+ * - 統計追蹤和事件監聽
+ * - 批次操作支援
+ * - 快取預熱功能
+ */
+// 核心類別
+export { MemoryCache } from './memory-cache.js';
+export { CacheManager } from './cache-manager.js';
+// 策略相關
+export { LRUStrategy, LFUStrategy, FIFOStrategy, TTLStrategy, RandomStrategy, StrategyFactory } from './strategies.js';
+// 型別定義
+export { 
+// 列舉
+EvictionStrategy, CacheEventType } from './types.js';
+// 常用的預設配置
+export const DEFAULT_CACHE_OPTIONS = {
+    maxSize: 1000,
+    maxMemory: 50 * 1024 * 1024, // 50MB
+    defaultTTL: 0, // 永不過期
+    evictionStrategy: 'lru',
+    enableStats: false,
+    cleanupInterval: 60000 // 1分鐘
+};
+export const DEFAULT_MANAGER_OPTIONS = {
+    enableGlobalStats: false,
+    warmupConfig: {
+        enabled: false,
+        strategy: 'lazy'
+    },
+    persistenceConfig: {
+        enabled: false,
+        interval: 60000,
+        compression: false,
+        backup: {
+            enabled: false,
+            maxBackups: 3
+        }
+    }
+};
+/**
+ * 工廠函式：建立預設配置的 MemoryCache
+ */
+export function createMemoryCache(options) {
+    const { MemoryCache } = require('./memory-cache');
+    return new MemoryCache({ ...DEFAULT_CACHE_OPTIONS, ...options });
+}
+/**
+ * 工廠函式：建立預設配置的 CacheManager
+ */
+export function createCacheManager(options) {
+    const { CacheManager } = require('./cache-manager');
+    return new CacheManager({ ...DEFAULT_MANAGER_OPTIONS, ...options });
+}
+/**
+ * 工廠函式：建立 LRU 快取
+ */
+export function createLRUCache(maxSize = 1000) {
+    return createMemoryCache({
+        maxSize,
+        evictionStrategy: 'lru',
+        enableStats: true
+    });
+}
+/**
+ * 工廠函式：建立帶 TTL 的快取
+ */
+export function createTTLCache(defaultTTL, maxSize = 1000) {
+    return createMemoryCache({
+        maxSize,
+        defaultTTL,
+        evictionStrategy: 'ttl',
+        enableStats: true
+    });
+}
+/**
+ * 工廠函式：建立高效能快取（針對高頻存取優化）
+ */
+export function createHighPerformanceCache(options) {
+    return createMemoryCache({
+        maxSize: options?.maxSize ?? 10000,
+        evictionStrategy: options?.strategy ?? 'lru',
+        enableStats: false, // 停用統計以獲得更好效能
+        cleanupInterval: 300000 // 5分鐘清理一次
+    });
+}
+/**
+ * 快取工具函式
+ */
+export class CacheUtils {
+    /**
+     * 計算快取命中率
+     */
+    static calculateHitRate(hits, misses) {
+        const total = hits + misses;
+        return total > 0 ? hits / total : 0;
+    }
+    /**
+     * 格式化記憶體大小
+     */
+    static formatMemorySize(bytes) {
+        const units = ['B', 'KB', 'MB', 'GB'];
+        let size = bytes;
+        let unitIndex = 0;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        return `${size.toFixed(2)} ${units[unitIndex]}`;
+    }
+    /**
+     * 合併多個快取統計
+     */
+    static mergeStats(statsArray) {
+        if (statsArray.length === 0) {
+            return {
+                totalRequests: 0,
+                hits: 0,
+                misses: 0,
+                hitRate: 0,
+                size: 0,
+                memoryUsage: 0,
+                evictions: 0,
+                expirations: 0,
+                averageAccessTime: 0
+            };
+        }
+        const merged = statsArray.reduce((acc, stats) => ({
+            totalRequests: acc.totalRequests + stats.totalRequests,
+            hits: acc.hits + stats.hits,
+            misses: acc.misses + stats.misses,
+            hitRate: 0, // 稍後計算
+            size: acc.size + stats.size,
+            memoryUsage: acc.memoryUsage + stats.memoryUsage,
+            evictions: acc.evictions + stats.evictions,
+            expirations: acc.expirations + stats.expirations,
+            averageAccessTime: acc.averageAccessTime + stats.averageAccessTime
+        }));
+        // 計算平均值
+        merged.hitRate = this.calculateHitRate(merged.hits, merged.misses);
+        merged.averageAccessTime = merged.averageAccessTime / statsArray.length;
+        return merged;
+    }
+    /**
+     * 產生快取鍵的雜湊值
+     */
+    static hashKey(key) {
+        if (typeof key === 'string') {
+            return key;
+        }
+        if (typeof key === 'number') {
+            return key.toString();
+        }
+        try {
+            return JSON.stringify(key);
+        }
+        catch {
+            return key.toString();
+        }
+    }
+    /**
+     * 驗證快取配置的合理性
+     */
+    static validateCacheOptions(options) {
+        const warnings = [];
+        if (options.maxSize && options.maxSize <= 0) {
+            warnings.push('maxSize should be greater than 0');
+        }
+        if (options.maxMemory && options.maxMemory <= 0) {
+            warnings.push('maxMemory should be greater than 0');
+        }
+        if (options.defaultTTL && options.defaultTTL < 0) {
+            warnings.push('defaultTTL should not be negative');
+        }
+        if (options.cleanupInterval && options.cleanupInterval < 1000) {
+            warnings.push('cleanupInterval should be at least 1000ms for performance reasons');
+        }
+        return warnings;
+    }
+}
+/**
+ * 快取效能監控器
+ */
+export class CacheMonitor {
+    caches = new Map();
+    constructor(_manager) {
+        // manager 參數保留以備未來使用
+    }
+    /**
+     * 監控單一快取
+     */
+    addCache(name, cache) {
+        this.caches.set(name, cache);
+    }
+    /**
+     * 移除監控的快取
+     */
+    removeCache(name) {
+        this.caches.delete(name);
+    }
+    /**
+     * 取得效能報告
+     */
+    getPerformanceReport() {
+        const cacheReports = Array.from(this.caches.entries()).map(([name, cache]) => {
+            const stats = cache.getStats();
+            const healthScore = this.calculateHealthScore(stats);
+            return { name, stats, healthScore };
+        });
+        const overallStats = CacheUtils.mergeStats(cacheReports.map(r => r.stats));
+        const overallHealthScore = this.calculateHealthScore(overallStats);
+        return {
+            caches: cacheReports,
+            overall: {
+                totalCaches: this.caches.size,
+                averageHitRate: overallStats.hitRate,
+                totalMemoryUsage: overallStats.memoryUsage,
+                healthScore: overallHealthScore
+            }
+        };
+    }
+    /**
+     * 計算快取健康評分（0-100）
+     */
+    calculateHealthScore(stats) {
+        // 命中率影響 (40%)
+        const hitRateScore = stats.hitRate * 40;
+        // 記憶體使用率影響 (30%)
+        const memoryScore = Math.max(0, 30 - (stats.memoryUsage / (50 * 1024 * 1024)) * 30);
+        // 存取時間影響 (20%)
+        const accessTimeScore = Math.max(0, 20 - Math.min(stats.averageAccessTime / 10, 20));
+        // 淘汰率影響 (10%)
+        const evictionRate = stats.totalRequests > 0 ? stats.evictions / stats.totalRequests : 0;
+        const evictionScore = Math.max(0, 10 - evictionRate * 100);
+        return Math.round(hitRateScore + memoryScore + accessTimeScore + evictionScore);
+    }
+}
+/**
+ * 版本資訊
+ */
+export const VERSION = '1.0.0';
+/**
+ * 快取系統資訊
+ */
+export const CACHE_SYSTEM_INFO = {
+    name: 'Agent IDE Cache System',
+    version: VERSION,
+    description: '高效能快取管理系統，支援多種淘汰策略和統計追蹤',
+    author: 'Agent IDE Team',
+    supportedStrategies: ['lru', 'lfu', 'fifo', 'ttl', 'random'],
+    features: [
+        '多種淘汰策略 (LRU, LFU, FIFO, TTL, Random)',
+        '記憶體管理和限制',
+        '統計追蹤和效能監控',
+        '事件系統',
+        '批次操作',
+        '快取預熱',
+        '並發安全'
+    ]
+};
+//# sourceMappingURL=index.js.map