agent-ide 0.1.0

package/dist/infrastructure/cache/strategies.js

@@ -0,0 +1,230 @@
+import { EvictionStrategy } from './types.js';
+/**
+ * LRU (Least Recently Used) 策略實作
+ */
+export class LRUStrategy {
+    name = EvictionStrategy.LRU;
+    head;
+    tail;
+    nodes = new Map();
+    onAccess(key, _item) {
+        this.moveToHead(key);
+    }
+    onSet(key, _item) {
+        if (this.nodes.has(key)) {
+            this.moveToHead(key);
+        }
+        else {
+            this.addToHead(key);
+        }
+    }
+    onDelete(key) {
+        this.removeNode(key);
+    }
+    selectEvictionKey(_items) {
+        return this.tail?.key;
+    }
+    clear() {
+        this.head = this.tail = undefined;
+        this.nodes.clear();
+    }
+    addToHead(key) {
+        const node = { key };
+        if (!this.head) {
+            this.head = node;
+            this.tail = node;
+        }
+        else {
+            node.next = this.head;
+            this.head.prev = node;
+            this.head = node;
+        }
+        this.nodes.set(key, node);
+    }
+    moveToHead(key) {
+        const node = this.nodes.get(key);
+        if (!node || node === this.head) {
+            return;
+        }
+        // 從當前位置移除
+        if (node.prev) {
+            node.prev.next = node.next;
+        }
+        if (node.next) {
+            node.next.prev = node.prev;
+        }
+        if (node === this.tail) {
+            this.tail = node.prev;
+        }
+        // 移動到頭部
+        node.prev = undefined;
+        node.next = this.head;
+        if (this.head) {
+            this.head.prev = node;
+        }
+        this.head = node;
+    }
+    removeNode(key) {
+        const node = this.nodes.get(key);
+        if (!node) {
+            return;
+        }
+        if (node.prev) {
+            node.prev.next = node.next;
+        }
+        if (node.next) {
+            node.next.prev = node.prev;
+        }
+        if (node === this.head) {
+            this.head = node.next;
+        }
+        if (node === this.tail) {
+            this.tail = node.prev;
+        }
+        this.nodes.delete(key);
+    }
+}
+/**
+ * LFU (Least Frequently Used) 策略實作
+ */
+export class LFUStrategy {
+    name = EvictionStrategy.LFU;
+    frequencies = new Map();
+    onAccess(key, item) {
+        // 存取次數已在 CacheItem 中追蹤，這裡只需要更新內部狀態
+        this.frequencies.set(key, item.accessCount);
+    }
+    onSet(key, _item) {
+        this.frequencies.set(key, 0);
+    }
+    onDelete(key) {
+        this.frequencies.delete(key);
+    }
+    selectEvictionKey(items) {
+        let minFrequency = Infinity;
+        let keyToEvict;
+        for (const [key, item] of items.entries()) {
+            if (item.accessCount < minFrequency) {
+                minFrequency = item.accessCount;
+                keyToEvict = key;
+            }
+        }
+        return keyToEvict;
+    }
+    clear() {
+        this.frequencies.clear();
+    }
+}
+/**
+ * FIFO (First In First Out) 策略實作
+ */
+export class FIFOStrategy {
+    name = EvictionStrategy.FIFO;
+    onAccess(_key, _item) {
+        // FIFO 不需要在存取時做任何事
+    }
+    onSet(_key, _item) {
+        // FIFO 不需要在設定時做任何事，因為時間戳記在 CacheItem 中
+    }
+    onDelete(_key) {
+        // FIFO 不需要在刪除時做任何事
+    }
+    selectEvictionKey(items) {
+        let earliestTime = Infinity;
+        let keyToEvict;
+        for (const [key, item] of items.entries()) {
+            if (item.createdAt < earliestTime) {
+                earliestTime = item.createdAt;
+                keyToEvict = key;
+            }
+        }
+        return keyToEvict;
+    }
+    clear() {
+        // FIFO 不需要清理任何狀態
+    }
+}
+/**
+ * TTL (Time To Live) 策略實作
+ */
+export class TTLStrategy {
+    name = EvictionStrategy.TTL;
+    onAccess(_key, _item) {
+        // TTL 不需要在存取時做任何事
+    }
+    onSet(_key, _item) {
+        // TTL 不需要在設定時做任何事
+    }
+    onDelete(_key) {
+        // TTL 不需要在刪除時做任何事
+    }
+    selectEvictionKey(items) {
+        const now = Date.now();
+        let earliestExpiry = Infinity;
+        let keyToEvict;
+        for (const [key, item] of items.entries()) {
+            if (item.expiresAt) {
+                if (now >= item.expiresAt) {
+                    // 已過期，優先淘汰
+                    return key;
+                }
+                if (item.expiresAt < earliestExpiry) {
+                    earliestExpiry = item.expiresAt;
+                    keyToEvict = key;
+                }
+            }
+        }
+        return keyToEvict;
+    }
+    clear() {
+        // TTL 不需要清理任何狀態
+    }
+}
+/**
+ * Random 隨機策略實作
+ */
+export class RandomStrategy {
+    name = EvictionStrategy.RANDOM;
+    onAccess(_key, _item) {
+        // Random 不需要在存取時做任何事
+    }
+    onSet(_key, _item) {
+        // Random 不需要在設定時做任何事
+    }
+    onDelete(_key) {
+        // Random 不需要在刪除時做任何事
+    }
+    selectEvictionKey(items) {
+        const keys = Array.from(items.keys());
+        if (keys.length === 0) {
+            return undefined;
+        }
+        const randomIndex = Math.floor(Math.random() * keys.length);
+        return keys[randomIndex];
+    }
+    clear() {
+        // Random 不需要清理任何狀態
+    }
+}
+/**
+ * 策略工廠
+ */
+export class StrategyFactory {
+    static createStrategy(strategy) {
+        switch (strategy) {
+            case EvictionStrategy.LRU:
+                return new LRUStrategy();
+            case EvictionStrategy.LFU:
+                return new LFUStrategy();
+            case EvictionStrategy.FIFO:
+                return new FIFOStrategy();
+            case EvictionStrategy.TTL:
+                return new TTLStrategy();
+            case EvictionStrategy.RANDOM:
+                return new RandomStrategy();
+            default:
+                throw new Error(`Unsupported eviction strategy: ${strategy}`);
+        }
+    }
+}
+//# sourceMappingURL=strategies.js.map

package/dist/infrastructure/cache/strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.js","sourceRoot":"","sources":["../../../src/infrastructure/cache/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAqC9D;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC;IAE7B,IAAI,CAAc;IAClB,IAAI,CAAc;IAClB,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEzC,QAAQ,CAAC,GAAM,EAAE,KAAmB;QAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAM,EAAE,KAAmB;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,GAAM;QACb,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,iBAAiB,CAAC,MAA4B;QAC5C,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,SAAgB,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,GAAM;QACtB,MAAM,IAAI,GAAe,EAAE,GAAG,EAAE,CAAC;QAEjC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEO,UAAU,CAAC,GAAM;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,OAAO;QAAA,CAAC;QAE1C,UAAU;QACV,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAAA,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAAA,CAAC;QAC5C,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAAA,CAAC;QAEhD,QAAQ;QACR,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAAA,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEO,UAAU,CAAC,GAAM;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,OAAO;QAAA,CAAC;QAEpB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAAA,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAAA,CAAC;QAE5C,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAAA,CAAC;QAChD,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAAA,CAAC;QAEhD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC;IAE7B,WAAW,GAAG,IAAI,GAAG,EAAa,CAAC;IAE3C,QAAQ,CAAC,GAAM,EAAE,IAAkB;QACjC,mCAAmC;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAM,EAAE,KAAmB;QAC/B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,GAAM;QACb,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,iBAAiB,CAAC,KAA2B;QAC3C,IAAI,YAAY,GAAG,QAAQ,CAAC;QAC5B,IAAI,UAAyB,CAAC;QAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC;gBACpC,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;gBAChC,UAAU,GAAG,GAAG,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC;IAEtC,QAAQ,CAAC,IAAO,EAAE,KAAmB;QACnC,mBAAmB;IACrB,CAAC;IAED,KAAK,CAAC,IAAO,EAAE,KAAmB;QAChC,uCAAuC;IACzC,CAAC;IAED,QAAQ,CAAC,IAAO;QACd,mBAAmB;IACrB,CAAC;IAED,iBAAiB,CAAC,KAA2B;QAC3C,IAAI,YAAY,GAAG,QAAQ,CAAC;QAC5B,IAAI,UAAyB,CAAC;QAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;gBAClC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC9B,UAAU,GAAG,GAAG,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK;QACH,iBAAiB;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC;IAErC,QAAQ,CAAC,IAAO,EAAE,KAAmB;QACnC,kBAAkB;IACpB,CAAC;IAED,KAAK,CAAC,IAAO,EAAE,KAAmB;QAChC,kBAAkB;IACpB,CAAC;IAED,QAAQ,CAAC,IAAO;QACd,kBAAkB;IACpB,CAAC;IAED,iBAAiB,CAAC,KAA2B;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,cAAc,GAAG,QAAQ,CAAC;QAC9B,IAAI,UAAyB,CAAC;QAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC1B,WAAW;oBACX,OAAO,GAAG,CAAC;gBACb,CAAC;gBAED,IAAI,IAAI,CAAC,SAAS,GAAG,cAAc,EAAE,CAAC;oBACpC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;oBAChC,UAAU,GAAG,GAAG,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,KAAK;QACH,gBAAgB;IAClB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAExC,QAAQ,CAAC,IAAO,EAAE,KAAmB;QACnC,qBAAqB;IACvB,CAAC;IAED,KAAK,CAAC,IAAO,EAAE,KAAmB;QAChC,qBAAqB;IACvB,CAAC;IAED,QAAQ,CAAC,IAAO;QACd,qBAAqB;IACvB,CAAC;IAED,iBAAiB,CAAC,KAA2B;QAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAAA,OAAO,SAAS,CAAC;QAAA,CAAC;QAE1C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,mBAAmB;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,cAAc,CAAO,QAA0B;QACpD,QAAQ,QAAQ,EAAE,CAAC;YACnB,KAAK,gBAAgB,CAAC,GAAG;gBACvB,OAAO,IAAI,WAAW,EAAQ,CAAC;YACjC,KAAK,gBAAgB,CAAC,GAAG;gBACvB,OAAO,IAAI,WAAW,EAAQ,CAAC;YACjC,KAAK,gBAAgB,CAAC,IAAI;gBACxB,OAAO,IAAI,YAAY,EAAQ,CAAC;YAClC,KAAK,gBAAgB,CAAC,GAAG;gBACvB,OAAO,IAAI,WAAW,EAAQ,CAAC;YACjC,KAAK,gBAAgB,CAAC,MAAM;gBAC1B,OAAO,IAAI,cAAc,EAAQ,CAAC;YACpC;gBACE,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,220 @@
+/**
+ * 快取系統的核心型別定義
+ */
+/**
+ * 快取項目的介面定義
+ */
+export interface CacheItem<V> {
+    /** 快取的值 */
+    value: V;
+    /** 建立時間戳記 */
+    createdAt: number;
+    /** 最後存取時間戳記 */
+    lastAccessedAt: number;
+    /** 存取次數 */
+    accessCount: number;
+    /** 過期時間戳記（可選） */
+    expiresAt?: number;
+    /** 資料大小（位元組，用於記憶體管理） */
+    size?: number;
+}
+/**
+ * 快取配置選項
+ */
+export interface CacheOptions {
+    /** 最大項目數量 */
+    maxSize?: number;
+    /** 最大記憶體使用量（位元組） */
+    maxMemory?: number;
+    /** 預設 TTL（毫秒） */
+    defaultTTL?: number;
+    /** 淘汰策略 */
+    evictionStrategy?: EvictionStrategy;
+    /** 是否啟用統計追蹤 */
+    enableStats?: boolean;
+    /** 自動清理間隔（毫秒） */
+    cleanupInterval?: number;
+    /** 序列化函式 */
+    serialize?: (value: any) => string;
+    /** 反序列化函式 */
+    deserialize?: (value: string) => any;
+}
+/**
+ * 淘汰策略列舉
+ */
+export declare enum EvictionStrategy {
+    /** Least Recently Used - 最近最少使用 */
+    LRU = "lru",
+    /** Least Frequently Used - 最不常使用 */
+    LFU = "lfu",
+    /** First In First Out - 先進先出 */
+    FIFO = "fifo",
+    /** Time To Live - 基於過期時間 */
+    TTL = "ttl",
+    /** Random - 隨機淘汰 */
+    RANDOM = "random"
+}
+/**
+ * 快取統計資訊
+ */
+export interface CacheStats {
+    /** 總請求次數 */
+    totalRequests: number;
+    /** 快取命中次數 */
+    hits: number;
+    /** 快取未命中次數 */
+    misses: number;
+    /** 命中率（0-1） */
+    hitRate: number;
+    /** 當前項目數量 */
+    size: number;
+    /** 當前記憶體使用量（位元組） */
+    memoryUsage: number;
+    /** 已淘汰的項目數量 */
+    evictions: number;
+    /** 已過期的項目數量 */
+    expirations: number;
+    /** 平均存取時間（毫秒） */
+    averageAccessTime: number;
+}
+/**
+ * 快取事件類型
+ */
+export declare enum CacheEventType {
+    /** 項目被設定 */
+    SET = "set",
+    /** 項目被取得 */
+    GET = "get",
+    /** 項目被刪除 */
+    DELETE = "delete",
+    /** 項目被淘汰 */
+    EVICT = "evict",
+    /** 項目過期 */
+    EXPIRE = "expire",
+    /** 快取被清空 */
+    CLEAR = "clear",
+    /** 快取命中 */
+    HIT = "hit",
+    /** 快取未命中 */
+    MISS = "miss"
+}
+/**
+ * 快取事件資料
+ */
+export interface CacheEvent<K, V> {
+    /** 事件類型 */
+    type: CacheEventType;
+    /** 快取鍵 */
+    key: K;
+    /** 快取值（可選） */
+    value?: V;
+    /** 事件發生時間 */
+    timestamp: number;
+    /** 額外的事件元資料 */
+    metadata?: Record<string, any>;
+}
+/**
+ * 快取事件監聽器
+ */
+export type CacheEventListener<K, V> = (event: CacheEvent<K, V>) => void;
+/**
+ * 雙向鏈表節點（用於 LRU 實作）
+ */
+export interface LRUNode<K, V> {
+    /** 節點鍵 */
+    key: K;
+    /** 快取項目 */
+    item: CacheItem<V>;
+    /** 前一個節點 */
+    prev?: LRUNode<K, V>;
+    /** 下一個節點 */
+    next?: LRUNode<K, V>;
+}
+/**
+ * 快取管理器配置
+ */
+export interface CacheManagerOptions {
+    /** 預設快取配置 */
+    defaultCacheOptions?: CacheOptions;
+    /** 是否啟用全域統計 */
+    enableGlobalStats?: boolean;
+    /** 快取預熱配置 */
+    warmupConfig?: WarmupConfig;
+    /** 持久化配置 */
+    persistenceConfig?: PersistenceConfig;
+}
+/**
+ * 快取預熱配置
+ */
+export interface WarmupConfig {
+    /** 是否啟用預熱 */
+    enabled: boolean;
+    /** 預熱資料來源 */
+    dataSource?: () => Promise<Map<any, any>>;
+    /** 預熱策略 */
+    strategy?: 'eager' | 'lazy';
+    /** 預熱完成回調 */
+    onComplete?: (stats: {
+        loaded: number;
+        failed: number;
+    }) => void;
+}
+/**
+ * 持久化配置
+ */
+export interface PersistenceConfig {
+    /** 是否啟用持久化 */
+    enabled: boolean;
+    /** 儲存路徑 */
+    filePath?: string;
+    /** 持久化間隔（毫秒） */
+    interval?: number;
+    /** 壓縮選項 */
+    compression?: boolean;
+    /** 備份配置 */
+    backup?: {
+        enabled: boolean;
+        maxBackups: number;
+    };
+}
+/**
+ * 批次操作結果
+ */
+export interface BatchResult<K, V> {
+    /** 成功的項目 */
+    success: Map<K, V>;
+    /** 失敗的項目 */
+    failed: Map<K, Error>;
+    /** 執行統計 */
+    stats: {
+        total: number;
+        successful: number;
+        failed: number;
+        duration: number;
+    };
+}
+/**
+ * 快取查詢選項
+ */
+export interface CacheQueryOptions {
+    /** 是否包含統計資訊 */
+    includeStats?: boolean;
+    /** 是否更新存取時間 */
+    updateAccessTime?: boolean;
+    /** 自訂 TTL */
+    customTTL?: number;
+}
+/**
+ * 快取鍵值對
+ */
+export type CacheEntry<K, V> = [K, V];
+/**
+ * 快取可序列化的值型別
+ */
+export type SerializableValue = string | number | boolean | null | undefined | SerializableObject | SerializableArray;
+export interface SerializableObject {
+    [key: string]: SerializableValue;
+}
+export interface SerializableArray extends Array<SerializableValue> {
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/infrastructure/cache/types.js

@@ -0,0 +1,42 @@
+/**
+ * 快取系統的核心型別定義
+ */
+/**
+ * 淘汰策略列舉
+ */
+export var EvictionStrategy;
+(function (EvictionStrategy) {
+    /** Least Recently Used - 最近最少使用 */
+    EvictionStrategy["LRU"] = "lru";
+    /** Least Frequently Used - 最不常使用 */
+    EvictionStrategy["LFU"] = "lfu";
+    /** First In First Out - 先進先出 */
+    EvictionStrategy["FIFO"] = "fifo";
+    /** Time To Live - 基於過期時間 */
+    EvictionStrategy["TTL"] = "ttl";
+    /** Random - 隨機淘汰 */
+    EvictionStrategy["RANDOM"] = "random";
+})(EvictionStrategy || (EvictionStrategy = {}));
+/**
+ * 快取事件類型
+ */
+export var CacheEventType;
+(function (CacheEventType) {
+    /** 項目被設定 */
+    CacheEventType["SET"] = "set";
+    /** 項目被取得 */
+    CacheEventType["GET"] = "get";
+    /** 項目被刪除 */
+    CacheEventType["DELETE"] = "delete";
+    /** 項目被淘汰 */
+    CacheEventType["EVICT"] = "evict";
+    /** 項目過期 */
+    CacheEventType["EXPIRE"] = "expire";
+    /** 快取被清空 */
+    CacheEventType["CLEAR"] = "clear";
+    /** 快取命中 */
+    CacheEventType["HIT"] = "hit";
+    /** 快取未命中 */
+    CacheEventType["MISS"] = "miss";
+})(CacheEventType || (CacheEventType = {}));
+//# sourceMappingURL=types.js.map

package/dist/infrastructure/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/infrastructure/cache/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0CH;;GAEG;AACH,MAAM,CAAN,IAAY,gBAWX;AAXD,WAAY,gBAAgB;IAC1B,mCAAmC;IACnC,+BAAW,CAAA;IACX,oCAAoC;IACpC,+BAAW,CAAA;IACX,gCAAgC;IAChC,iCAAa,CAAA;IACb,4BAA4B;IAC5B,+BAAW,CAAA;IACX,oBAAoB;IACpB,qCAAiB,CAAA;AACnB,CAAC,EAXW,gBAAgB,KAAhB,gBAAgB,QAW3B;AA0BD;;GAEG;AACH,MAAM,CAAN,IAAY,cAiBX;AAjBD,WAAY,cAAc;IACxB,YAAY;IACZ,6BAAW,CAAA;IACX,YAAY;IACZ,6BAAW,CAAA;IACX,YAAY;IACZ,mCAAiB,CAAA;IACjB,YAAY;IACZ,iCAAe,CAAA;IACf,WAAW;IACX,mCAAiB,CAAA;IACjB,YAAY;IACZ,iCAAe,CAAA;IACf,WAAW;IACX,6BAAW,CAAA;IACX,YAAY;IACZ,+BAAa,CAAA;AACf,CAAC,EAjBW,cAAc,KAAd,cAAc,QAiBzB"}

package/dist/infrastructure/parser/base.d.ts

@@ -0,0 +1,126 @@
+/**
+ * BaseParserPlugin 抽象類別
+ * 提供 Parser 插件的基礎實作和通用功能
+ */
+import type { AST, Symbol, Reference, Dependency, Position, Range } from '../../shared/types/index.js';
+import type { ParserPlugin } from './interface.js';
+import type { CodeEdit, Definition, Usage, ValidationResult, ParserOptions, ParserCapabilities } from './types.js';
+/**
+ * 日誌等級
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * BaseParserPlugin 抽象類別
+ * 提供常用功能的預設實作，減少插件開發工作量
+ */
+export declare abstract class BaseParserPlugin implements ParserPlugin {
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly supportedExtensions: readonly string[];
+    abstract readonly supportedLanguages: readonly string[];
+    abstract parse(code: string, filePath: string): Promise<AST>;
+    private _initialized;
+    private _disposed;
+    private _options;
+    /**
+     * 從 AST 中提取符號（預設實作返回空陣列）
+     */
+    extractSymbols(_ast: AST): Promise<Symbol[]>;
+    /**
+     * 查找符號引用（預設實作返回空陣列）
+     */
+    findReferences(_ast: AST, symbol: Symbol): Promise<Reference[]>;
+    /**
+     * 提取依賴關係（預設實作返回空陣列）
+     */
+    extractDependencies(_ast: AST): Promise<Dependency[]>;
+    /**
+     * 重新命名（預設實作返回空陣列）
+     */
+    rename(_ast: AST, position: Position, newName: string): Promise<CodeEdit[]>;
+    /**
+     * 提取函式（預設實作返回空陣列）
+     */
+    extractFunction(_ast: AST, _selection: Range): Promise<CodeEdit[]>;
+    /**
+     * 查找定義（預設實作返回 null）
+     */
+    findDefinition(_ast: AST, position: Position): Promise<Definition | null>;
+    /**
+     * 查找使用位置（預設實作返回空陣列）
+     */
+    findUsages(_ast: AST, symbol: Symbol): Promise<Usage[]>;
+    /**
+     * 驗證插件狀態（預設實作返回成功）
+     */
+    validate(): Promise<ValidationResult>;
+    /**
+     * 清理資源（預設實作）
+     */
+    dispose(): Promise<void>;
+    /**
+     * 初始化插件
+     */
+    initialize(options?: ParserOptions): Promise<void>;
+    /**
+     * 檢查是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 檢查是否已清理
+     */
+    isDisposed(): boolean;
+    /**
+     * 獲取預設配置選項
+     */
+    getDefaultOptions(): ParserOptions;
+    /**
+     * 更新配置選項
+     */
+    updateOptions(options: Partial<ParserOptions>): void;
+    /**
+     * 獲取插件能力聲明
+     */
+    getCapabilities(): ParserCapabilities;
+    /**
+     * 處理錯誤
+     */
+    handleError(error: Error, context?: string): void;
+    /**
+     * 記錄日誌
+     */
+    log(level: LogLevel, message: string): void;
+    /**
+     * 驗證檔案路徑
+     */
+    validateFilePath(filePath: string): boolean;
+    /**
+     * 驗證程式碼內容
+     */
+    validateCode(code: string): boolean;
+    /**
+     * 驗證位置
+     */
+    validatePosition(position: Position): boolean;
+    /**
+     * 驗證範圍
+     */
+    validateRange(range: Range): boolean;
+    /**
+     * 從檔案路徑獲取副檔名
+     */
+    protected getFileExtension(filePath: string): string;
+    /**
+     * 檢查插件是否支援特定檔案
+     */
+    protected supportsFile(filePath: string): boolean;
+    /**
+     * 建立基本的 CodeEdit
+     */
+    protected createCodeEdit(filePath: string, range: Range, newText: string, editType?: 'rename' | 'extract' | 'inline' | 'format'): CodeEdit;
+    /**
+     * 安全執行異步操作
+     */
+    protected safeExecute<T>(operation: () => Promise<T>, defaultValue: T, context?: string): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/infrastructure/parser/base.d.ts.map

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