agent-ide 0.1.0

package/dist/application/state/application-state.js

@@ -0,0 +1,290 @@
+/**
+ * 應用程式全域狀態管理類別
+ *
+ * 負責管理應用程式的全域狀態，包括：
+ * - 應用程式基本資訊（版本、環境等）
+ * - 模組狀態管理
+ * - 全域設定
+ * - 快取統計
+ * - 效能指標
+ * - 狀態持久化和恢復
+ */
+export class ApplicationState {
+    version;
+    environment;
+    isInitialized;
+    moduleStates;
+    globalSettings;
+    cacheStats;
+    performanceMetrics;
+    constructor(initialSettings = {}) {
+        this.version = '1.0.0';
+        this.environment = 'development';
+        this.isInitialized = false;
+        this.moduleStates = {};
+        this.globalSettings = initialSettings;
+        this.cacheStats = {
+            hitCount: 0,
+            missCount: 0,
+            totalSize: 0
+        };
+        this.performanceMetrics = {
+            startTime: new Date(),
+            totalOperations: 0,
+            averageResponseTime: 0
+        };
+    }
+    /**
+     * 從 JSON 數據建立 ApplicationState 實例
+     */
+    static fromJSON(data) {
+        const instance = new ApplicationState(data.globalSettings);
+        return Object.assign(Object.create(Object.getPrototypeOf(instance)), {
+            ...instance,
+            version: data.version || '1.0.0',
+            environment: data.environment || 'development',
+            isInitialized: data.isInitialized ?? false,
+            moduleStates: data.moduleStates || {},
+            globalSettings: data.globalSettings || {},
+            cacheStats: data.cacheStats || instance.cacheStats,
+            performanceMetrics: data.performanceMetrics ? {
+                ...data.performanceMetrics,
+                startTime: new Date(data.performanceMetrics.startTime)
+            } : instance.performanceMetrics
+        });
+    }
+    /**
+     * 標記應用程式為已初始化
+     */
+    markInitialized() {
+        return this.clone({
+            isInitialized: true
+        });
+    }
+    /**
+     * 更新版本
+     */
+    updateVersion(version) {
+        return this.clone({
+            version
+        });
+    }
+    /**
+     * 設定環境
+     */
+    setEnvironment(environment) {
+        return this.clone({
+            environment
+        });
+    }
+    /**
+     * 設定模組狀態
+     */
+    setModuleState(moduleId, state) {
+        return this.clone({
+            moduleStates: {
+                ...this.moduleStates,
+                [moduleId]: state
+            }
+        });
+    }
+    /**
+     * 批次設定模組狀態
+     */
+    setModuleStates(states) {
+        return this.clone({
+            moduleStates: {
+                ...this.moduleStates,
+                ...states
+            }
+        });
+    }
+    /**
+     * 獲取模組狀態
+     */
+    getModuleState(moduleId) {
+        return this.moduleStates[moduleId];
+    }
+    /**
+     * 移除模組狀態
+     */
+    removeModuleState(moduleId) {
+        const newModuleStates = { ...this.moduleStates };
+        delete newModuleStates[moduleId];
+        return this.clone({
+            moduleStates: newModuleStates
+        });
+    }
+    /**
+     * 更新全域設定
+     */
+    updateSettings(settings) {
+        return this.clone({
+            globalSettings: {
+                ...this.globalSettings,
+                ...settings
+            }
+        });
+    }
+    /**
+     * 獲取設定值
+     */
+    getSetting(key) {
+        return this.globalSettings[key];
+    }
+    /**
+     * 移除設定
+     */
+    removeSetting(key) {
+        const newSettings = { ...this.globalSettings };
+        delete newSettings[key];
+        return this.clone({
+            globalSettings: newSettings
+        });
+    }
+    /**
+     * 更新快取統計
+     */
+    updateCacheStats(stats) {
+        return this.clone({
+            cacheStats: stats
+        });
+    }
+    /**
+     * 增加快取命中次數
+     */
+    incrementCacheHit() {
+        return this.clone({
+            cacheStats: {
+                ...this.cacheStats,
+                hitCount: this.cacheStats.hitCount + 1
+            }
+        });
+    }
+    /**
+     * 增加快取未命中次數
+     */
+    incrementCacheMiss() {
+        return this.clone({
+            cacheStats: {
+                ...this.cacheStats,
+                missCount: this.cacheStats.missCount + 1
+            }
+        });
+    }
+    /**
+     * 計算快取命中率
+     */
+    getCacheHitRate() {
+        const total = this.cacheStats.hitCount + this.cacheStats.missCount;
+        if (total === 0) {
+            return 0;
+        }
+        return this.cacheStats.hitCount / total;
+    }
+    /**
+     * 更新效能指標
+     */
+    updatePerformanceMetrics(metrics) {
+        return this.clone({
+            performanceMetrics: metrics
+        });
+    }
+    /**
+     * 記錄操作
+     */
+    recordOperation(responseTime) {
+        const currentTotal = this.performanceMetrics.totalOperations;
+        const currentAverage = this.performanceMetrics.averageResponseTime;
+        const newTotal = currentTotal + 1;
+        const newAverage = (currentAverage * currentTotal + responseTime) / newTotal;
+        return this.clone({
+            performanceMetrics: {
+                ...this.performanceMetrics,
+                totalOperations: newTotal,
+                averageResponseTime: newAverage
+            }
+        });
+    }
+    /**
+     * 獲取運行時間（毫秒）
+     */
+    getRuntime() {
+        return Date.now() - this.performanceMetrics.startTime.getTime();
+    }
+    /**
+     * 驗證狀態完整性
+     */
+    isValid() {
+        // 檢查基本屬性
+        if (!this.version || typeof this.version !== 'string') {
+            return false;
+        }
+        if (!['development', 'production', 'test'].includes(this.environment)) {
+            return false;
+        }
+        // 檢查快取統計
+        if (this.cacheStats.hitCount < 0 || this.cacheStats.missCount < 0 || this.cacheStats.totalSize < 0) {
+            return false;
+        }
+        // 檢查效能指標
+        if (this.performanceMetrics.totalOperations < 0 || this.performanceMetrics.averageResponseTime < 0) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 獲取狀態摘要
+     */
+    getSummary() {
+        return {
+            version: this.version,
+            environment: this.environment,
+            isInitialized: this.isInitialized,
+            moduleCount: Object.keys(this.moduleStates).length,
+            settingsCount: Object.keys(this.globalSettings).length,
+            cacheHitRate: this.getCacheHitRate(),
+            totalOperations: this.performanceMetrics.totalOperations,
+            runtime: this.getRuntime()
+        };
+    }
+    /**
+     * 重設所有狀態
+     */
+    reset() {
+        return new ApplicationState();
+    }
+    /**
+     * 重設模組狀態
+     */
+    resetModuleStates() {
+        return this.clone({
+            moduleStates: {}
+        });
+    }
+    /**
+     * 序列化為 JSON
+     */
+    toJSON() {
+        return {
+            version: this.version,
+            environment: this.environment,
+            isInitialized: this.isInitialized,
+            moduleStates: this.moduleStates,
+            globalSettings: this.globalSettings,
+            cacheStats: this.cacheStats,
+            performanceMetrics: this.performanceMetrics
+        };
+    }
+    /**
+     * 克隆狀態並應用變更（不可變更新）
+     */
+    clone(changes) {
+        const instance = Object.create(Object.getPrototypeOf(this));
+        return Object.assign(instance, {
+            ...this,
+            ...changes
+        });
+    }
+}
+//# sourceMappingURL=application-state.js.map

package/dist/application/state/application-state.js.map

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

package/dist/application/state/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Application State 模組
+ *
+ * 提供完整的狀態管理解決方案，包括：
+ * - 會話狀態管理
+ * - 應用程式全域狀態
+ * - 統一的狀態管理器
+ * - 不可變狀態更新
+ * - 狀態持久化支援
+ * - 時間旅行除錯支援
+ */
+export { SessionState, type SessionOptions, type OperationRecord, type SessionContext, type SessionStateData } from './session-state.js';
+export { ApplicationState, type Environment, type ModuleState, type CacheStats, type PerformanceMetrics, type ApplicationStateData, type StateSummary } from './application-state.js';
+export { StateManager, type StateSnapshot, type StateManagerStats, type HealthCheck, type StateEvent } from './state-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/application/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/application/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzI,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtL,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/application/state/index.js

@@ -0,0 +1,15 @@
+/**
+ * Application State 模組
+ *
+ * 提供完整的狀態管理解決方案，包括：
+ * - 會話狀態管理
+ * - 應用程式全域狀態
+ * - 統一的狀態管理器
+ * - 不可變狀態更新
+ * - 狀態持久化支援
+ * - 時間旅行除錯支援
+ */
+export { SessionState } from './session-state.js';
+export { ApplicationState } from './application-state.js';
+export { StateManager } from './state-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/application/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/application/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAyF,MAAM,oBAAoB,CAAC;AACzI,OAAO,EAAE,gBAAgB,EAA8H,MAAM,wBAAwB,CAAC;AACtL,OAAO,EAAE,YAAY,EAAiF,MAAM,oBAAoB,CAAC"}

package/dist/application/state/session-state.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 會話狀態管理類別
+ *
+ * 負責管理用戶會話的狀態，包括：
+ * - 會話基本資訊（ID、用戶、創建時間等）
+ * - 會話上下文（工作目錄、當前檔案等）
+ * - 操作歷史記錄
+ * - 狀態不可變更新
+ * - 時間旅行除錯支援
+ */
+export interface SessionOptions {
+    /** 最大歷史記錄數量 */
+    maxHistorySize?: number;
+    /** 會話逾時時間（毫秒） */
+    timeoutMs?: number;
+}
+export interface OperationRecord {
+    /** 操作唯一 ID */
+    id: string;
+    /** 操作類型 */
+    type: 'rename' | 'move' | 'refactor' | 'analyze' | 'search' | 'index';
+    /** 操作時間戳 */
+    timestamp: Date;
+    /** 操作描述 */
+    description: string;
+    /** 操作相關的元數據 */
+    metadata: Record<string, unknown>;
+}
+export interface SessionContext {
+    /** 工作目錄 */
+    workingDirectory?: string;
+    /** 當前檔案 */
+    currentFile?: string;
+    /** 其他上下文資料 */
+    [key: string]: unknown;
+}
+export interface SessionStateData {
+    sessionId: string;
+    userId?: string;
+    isActive: boolean;
+    createdAt: Date;
+    lastAccessedAt: Date;
+    context: SessionContext;
+    operationHistory: OperationRecord[];
+    options: SessionOptions;
+}
+export declare class SessionState {
+    readonly sessionId: string;
+    readonly userId?: string;
+    readonly isActive: boolean;
+    readonly createdAt: Date;
+    readonly lastAccessedAt: Date;
+    readonly context: SessionContext;
+    readonly operationHistory: OperationRecord[];
+    readonly options: SessionOptions;
+    constructor(sessionId: string, userId?: string, options?: SessionOptions);
+    /**
+     * 從 JSON 數據建立 SessionState 實例
+     */
+    static fromJSON(data: Partial<SessionStateData>): SessionState;
+    /**
+     * 更新會話上下文
+     */
+    updateContext(newContext: Partial<SessionContext>): SessionState;
+    /**
+     * 更新最後存取時間
+     */
+    updateLastAccess(): SessionState;
+    /**
+     * 停用會話
+     */
+    deactivate(): SessionState;
+    /**
+     * 啟用會話
+     */
+    activate(): SessionState;
+    /**
+     * 添加操作記錄
+     */
+    addOperation(operation: OperationRecord): SessionState;
+    /**
+     * 批次添加操作記錄
+     */
+    addOperations(operations: OperationRecord[]): this;
+    /**
+     * 清空操作歷史
+     */
+    clearHistory(): SessionState;
+    /**
+     * 檢查會話是否已過期
+     */
+    isExpired(): boolean;
+    /**
+     * 獲取會話持續時間（毫秒）
+     */
+    getDuration(): number;
+    /**
+     * 回到指定操作的狀態（時間旅行除錯）
+     */
+    revertToOperation(operationId: string): SessionState;
+    /**
+     * 獲取指定時間點的狀態快照
+     */
+    getSnapshotAtTime(timestamp: Date): SessionState;
+    /**
+     * 序列化為 JSON
+     */
+    toJSON(): SessionStateData;
+    /**
+     * 克隆狀態並應用變更（不可變更新）
+     */
+    private clone;
+}
+//# sourceMappingURL=session-state.d.ts.map

package/dist/application/state/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../../src/application/state/session-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,eAAe;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtE,YAAY;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAG/B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB;IAkB9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,YAAY;IAmB9D;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,YAAY;IAOhE;;OAEG;IACH,gBAAgB,IAAI,YAAY;IAMhC;;OAEG;IACH,UAAU,IAAI,YAAY;IAO1B;;OAEG;IACH,QAAQ,IAAI,YAAY;IAOxB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,YAAY;IAetD;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,IAAI;IAQlD;;OAEG;IACH,YAAY,IAAI,YAAY;IAO5B;;OAEG;IACH,SAAS,IAAI,OAAO;IAUpB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;IAepD;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,IAAI,GAAG,YAAY;IAYhD;;OAEG;IACH,MAAM,IAAI,gBAAgB;IAa1B;;OAEG;IACH,OAAO,CAAC,KAAK;CAOd"}

package/dist/application/state/session-state.js

@@ -0,0 +1,188 @@
+/**
+ * 會話狀態管理類別
+ *
+ * 負責管理用戶會話的狀態，包括：
+ * - 會話基本資訊（ID、用戶、創建時間等）
+ * - 會話上下文（工作目錄、當前檔案等）
+ * - 操作歷史記錄
+ * - 狀態不可變更新
+ * - 時間旅行除錯支援
+ */
+export class SessionState {
+    sessionId;
+    userId;
+    isActive;
+    createdAt;
+    lastAccessedAt;
+    context;
+    operationHistory;
+    options;
+    constructor(sessionId, userId, options = {}) {
+        const now = new Date();
+        this.sessionId = sessionId;
+        this.userId = userId;
+        this.isActive = true;
+        this.createdAt = now;
+        this.lastAccessedAt = now;
+        this.context = {};
+        this.operationHistory = [];
+        this.options = {
+            maxHistorySize: 1000,
+            timeoutMs: 30 * 60 * 1000, // 30 分鐘
+            ...options
+        };
+    }
+    /**
+     * 從 JSON 數據建立 SessionState 實例
+     */
+    static fromJSON(data) {
+        const instance = new SessionState(data.sessionId || '', data.userId, data.options);
+        // 使用 Object.assign 來設定所有屬性
+        return Object.assign(Object.create(Object.getPrototypeOf(instance)), {
+            ...instance,
+            isActive: data.isActive ?? true,
+            createdAt: data.createdAt ? new Date(data.createdAt) : instance.createdAt,
+            lastAccessedAt: data.lastAccessedAt ? new Date(data.lastAccessedAt) : instance.lastAccessedAt,
+            context: data.context || {},
+            operationHistory: data.operationHistory || [],
+            options: data.options || instance.options
+        });
+    }
+    /**
+     * 更新會話上下文
+     */
+    updateContext(newContext) {
+        return this.clone({
+            context: { ...this.context, ...newContext },
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 更新最後存取時間
+     */
+    updateLastAccess() {
+        return this.clone({
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 停用會話
+     */
+    deactivate() {
+        return this.clone({
+            isActive: false,
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 啟用會話
+     */
+    activate() {
+        return this.clone({
+            isActive: true,
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 添加操作記錄
+     */
+    addOperation(operation) {
+        const newHistory = [...this.operationHistory, operation];
+        // 檢查是否超過最大歷史記錄數量
+        const maxSize = this.options.maxHistorySize || 1000;
+        if (newHistory.length > maxSize) {
+            newHistory.splice(0, newHistory.length - maxSize);
+        }
+        return this.clone({
+            operationHistory: newHistory,
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 批次添加操作記錄
+     */
+    addOperations(operations) {
+        let state = this;
+        for (const operation of operations) {
+            state = state.addOperation(operation);
+        }
+        return state;
+    }
+    /**
+     * 清空操作歷史
+     */
+    clearHistory() {
+        return this.clone({
+            operationHistory: [],
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 檢查會話是否已過期
+     */
+    isExpired() {
+        if (!this.options.timeoutMs) {
+            return false;
+        }
+        const now = Date.now();
+        const lastAccess = this.lastAccessedAt.getTime();
+        return (now - lastAccess) > this.options.timeoutMs;
+    }
+    /**
+     * 獲取會話持續時間（毫秒）
+     */
+    getDuration() {
+        return Date.now() - this.createdAt.getTime();
+    }
+    /**
+     * 回到指定操作的狀態（時間旅行除錯）
+     */
+    revertToOperation(operationId) {
+        const operationIndex = this.operationHistory.findIndex(op => op.id === operationId);
+        if (operationIndex === -1) {
+            return this;
+        }
+        const newHistory = this.operationHistory.slice(0, operationIndex + 1);
+        return this.clone({
+            operationHistory: newHistory,
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 獲取指定時間點的狀態快照
+     */
+    getSnapshotAtTime(timestamp) {
+        const targetTime = timestamp.getTime();
+        const historyUpToTime = this.operationHistory.filter(op => op.timestamp.getTime() <= targetTime);
+        return this.clone({
+            operationHistory: historyUpToTime,
+            lastAccessedAt: new Date()
+        });
+    }
+    /**
+     * 序列化為 JSON
+     */
+    toJSON() {
+        return {
+            sessionId: this.sessionId,
+            userId: this.userId,
+            isActive: this.isActive,
+            createdAt: this.createdAt,
+            lastAccessedAt: this.lastAccessedAt,
+            context: this.context,
+            operationHistory: this.operationHistory,
+            options: this.options
+        };
+    }
+    /**
+     * 克隆狀態並應用變更（不可變更新）
+     */
+    clone(changes) {
+        const instance = Object.create(Object.getPrototypeOf(this));
+        return Object.assign(instance, {
+            ...this,
+            ...changes
+        });
+    }
+}
+//# sourceMappingURL=session-state.js.map

package/dist/application/state/session-state.js.map

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