agent-ide 0.1.0

package/dist/infrastructure/storage/file-system.d.ts

@@ -0,0 +1,74 @@
+import { DirectoryEntry, FileStats, GlobOptions, AtomicWriteOptions } from './types.js';
+/**
+ * 檔案系統操作類別
+ * 提供統一的檔案和目錄操作介面
+ */
+export declare class FileSystem {
+    private readonly tempSuffix;
+    /**
+     * 讀取檔案內容
+     */
+    readFile(filePath: string, encoding?: BufferEncoding): Promise<string | Buffer>;
+    /**
+     * 寫入檔案內容
+     * 自動建立不存在的目錄
+     */
+    writeFile(filePath: string, content: string | Buffer, options?: AtomicWriteOptions): Promise<void>;
+    /**
+     * 原子寫入檔案
+     */
+    private atomicWrite;
+    /**
+     * 追加檔案內容
+     */
+    appendFile(filePath: string, content: string | Buffer): Promise<void>;
+    /**
+     * 刪除檔案
+     */
+    deleteFile(filePath: string): Promise<void>;
+    /**
+     * 建立目錄
+     */
+    createDirectory(dirPath: string, recursive?: boolean): Promise<void>;
+    /**
+     * 讀取目錄內容
+     */
+    readDirectory(dirPath: string): Promise<DirectoryEntry[]>;
+    /**
+     * 刪除目錄
+     */
+    deleteDirectory(dirPath: string, recursive?: boolean): Promise<void>;
+    /**
+     * 檢查路徑是否存在
+     */
+    exists(targetPath: string): Promise<boolean>;
+    /**
+     * 獲取檔案統計資訊
+     */
+    getStats(targetPath: string): Promise<FileStats>;
+    /**
+     * 安全獲取檔案統計資訊（不拋出錯誤）
+     */
+    private safeGetStats;
+    /**
+     * 檢查是否為檔案
+     */
+    isFile(targetPath: string): Promise<boolean>;
+    /**
+     * 檢查是否為目錄
+     */
+    isDirectory(targetPath: string): Promise<boolean>;
+    /**
+     * 複製檔案
+     */
+    copyFile(srcPath: string, destPath: string): Promise<void>;
+    /**
+     * 移動檔案
+     */
+    moveFile(srcPath: string, destPath: string): Promise<void>;
+    /**
+     * Glob 搜尋檔案
+     */
+    glob(pattern: string, options?: GlobOptions): Promise<string[]>;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/infrastructure/storage/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/file-system.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,EACd,SAAS,EACT,WAAW,EAMX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAiBrF;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxG;;OAEG;YACW,WAAW;IA2BzB;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3E;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjD;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAexE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA+B/D;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxE;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAyBtD;;OAEG;YACW,YAAY;IAQ1B;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBhE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBhE;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAgB1E"}

package/dist/infrastructure/storage/file-system.js

@@ -0,0 +1,334 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { glob as globby } from 'glob';
+import { FileNotFoundError, DirectoryNotFoundError, PermissionError, DirectoryNotEmptyError, } from './types.js';
+/**
+ * 檔案系統操作類別
+ * 提供統一的檔案和目錄操作介面
+ */
+export class FileSystem {
+    tempSuffix = '.tmp';
+    /**
+     * 讀取檔案內容
+     */
+    async readFile(filePath, encoding) {
+        try {
+            if (encoding) {
+                return await fs.readFile(filePath, encoding);
+            }
+            return await fs.readFile(filePath);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new FileNotFoundError(filePath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(filePath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 寫入檔案內容
+     * 自動建立不存在的目錄
+     */
+    async writeFile(filePath, content, options) {
+        try {
+            // 確保目錄存在
+            const dir = path.dirname(filePath);
+            await this.createDirectory(dir, true);
+            if (options?.fsync) {
+                // 使用原子寫入
+                await this.atomicWrite(filePath, content, options);
+            }
+            else {
+                // 直接寫入
+                await fs.writeFile(filePath, content, { encoding: options?.encoding });
+            }
+        }
+        catch (error) {
+            if (error.code === 'EACCES') {
+                throw new PermissionError(filePath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 原子寫入檔案
+     */
+    async atomicWrite(filePath, content, options) {
+        const tempPath = filePath + (options.tempSuffix || this.tempSuffix);
+        try {
+            await fs.writeFile(tempPath, content, { encoding: options.encoding });
+            if (options.fsync) {
+                const fd = await fs.open(tempPath, 'r+');
+                try {
+                    await fd.sync();
+                }
+                finally {
+                    await fd.close();
+                }
+            }
+            await fs.rename(tempPath, filePath);
+        }
+        catch (error) {
+            // 清理暫存檔案
+            try {
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // 忽略清理錯誤
+            }
+            throw error;
+        }
+    }
+    /**
+     * 追加檔案內容
+     */
+    async appendFile(filePath, content) {
+        try {
+            await fs.appendFile(filePath, content);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new FileNotFoundError(filePath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(filePath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 刪除檔案
+     */
+    async deleteFile(filePath) {
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new FileNotFoundError(filePath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(filePath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 建立目錄
+     */
+    async createDirectory(dirPath, recursive = false) {
+        try {
+            await fs.mkdir(dirPath, { recursive });
+        }
+        catch (error) {
+            if (error.code === 'EEXIST') {
+                // 目錄已存在，不是錯誤
+                return;
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(dirPath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 讀取目錄內容
+     */
+    async readDirectory(dirPath) {
+        try {
+            const entries = await fs.readdir(dirPath, { withFileTypes: true });
+            const result = [];
+            for (const entry of entries) {
+                const entryPath = path.join(dirPath, entry.name);
+                const stats = await this.safeGetStats(entryPath);
+                result.push({
+                    name: entry.name,
+                    path: entryPath,
+                    isFile: entry.isFile(),
+                    isDirectory: entry.isDirectory(),
+                    size: stats?.size,
+                    modifiedTime: stats?.modifiedTime,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new DirectoryNotFoundError(dirPath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(dirPath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 刪除目錄
+     */
+    async deleteDirectory(dirPath, recursive = false) {
+        try {
+            if (recursive) {
+                await fs.rm(dirPath, { recursive: true, force: false });
+            }
+            else {
+                await fs.rmdir(dirPath);
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new DirectoryNotFoundError(dirPath, error);
+            }
+            if (error.code === 'ENOTEMPTY') {
+                throw new DirectoryNotEmptyError(dirPath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(dirPath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 檢查路徑是否存在
+     */
+    async exists(targetPath) {
+        try {
+            await fs.access(targetPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 獲取檔案統計資訊
+     */
+    async getStats(targetPath) {
+        try {
+            const stats = await fs.stat(targetPath);
+            return {
+                isFile: stats.isFile(),
+                isDirectory: stats.isDirectory(),
+                size: stats.size,
+                createdTime: stats.birthtime,
+                modifiedTime: stats.mtime,
+                accessedTime: stats.atime,
+                mode: stats.mode,
+                uid: stats.uid,
+                gid: stats.gid,
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new FileNotFoundError(targetPath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(targetPath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 安全獲取檔案統計資訊（不拋出錯誤）
+     */
+    async safeGetStats(targetPath) {
+        try {
+            return await this.getStats(targetPath);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 檢查是否為檔案
+     */
+    async isFile(targetPath) {
+        try {
+            const stats = await this.getStats(targetPath);
+            return stats.isFile;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 檢查是否為目錄
+     */
+    async isDirectory(targetPath) {
+        try {
+            const stats = await this.getStats(targetPath);
+            return stats.isDirectory;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 複製檔案
+     */
+    async copyFile(srcPath, destPath) {
+        try {
+            // 確保目標目錄存在
+            const destDir = path.dirname(destPath);
+            await this.createDirectory(destDir, true);
+            await fs.copyFile(srcPath, destPath);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT' && error.path === srcPath) {
+                throw new FileNotFoundError(srcPath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(error.path || srcPath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 移動檔案
+     */
+    async moveFile(srcPath, destPath) {
+        try {
+            // 確保目標目錄存在
+            const destDir = path.dirname(destPath);
+            await this.createDirectory(destDir, true);
+            await fs.rename(srcPath, destPath);
+        }
+        catch (error) {
+            if (error.code === 'EXDEV') {
+                // 跨裝置移動，使用複製+刪除
+                await this.copyFile(srcPath, destPath);
+                await this.deleteFile(srcPath);
+                return;
+            }
+            if (error.code === 'ENOENT') {
+                throw new FileNotFoundError(srcPath, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new PermissionError(error.path || srcPath, error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Glob 搜尋檔案
+     */
+    async glob(pattern, options = {}) {
+        try {
+            const results = await globby(pattern, {
+                cwd: options.cwd,
+                ignore: options.ignore,
+                dot: options.dot,
+                absolute: options.absolute,
+                // 移除不支援的選項
+                ...(options.followSymlinks && { followSymbolicLinks: options.followSymlinks }),
+            });
+            return results.sort();
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=file-system.js.map

package/dist/infrastructure/storage/file-system.js.map

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

package/dist/infrastructure/storage/file-watcher.d.ts

@@ -0,0 +1,84 @@
+import { EventEmitter } from 'events';
+import { WatchOptions, FileWatcherEventListener } from './types.js';
+/**
+ * 檔案監控器
+ * 基於 chokidar 提供檔案變更監控功能
+ */
+export declare class FileWatcher extends EventEmitter {
+    private watchers;
+    private readonly defaultOptions;
+    constructor();
+    /**
+     * 開始監控路徑
+     */
+    watch(watchPath: string, options?: WatchOptions): Promise<void>;
+    /**
+     * 設定事件處理器
+     */
+    private setupEventHandlers;
+    /**
+     * 轉換統計資訊格式
+     */
+    private convertStats;
+    /**
+     * 發送事件
+     */
+    private emitEvent;
+    /**
+     * 停止監控特定路徑
+     */
+    unwatch(watchPath: string): Promise<void>;
+    /**
+     * 新增監控路徑到現有 watcher
+     */
+    add(watchPath: string, filePath: string): Promise<void>;
+    /**
+     * 關閉所有監控
+     */
+    close(): Promise<void>;
+    /**
+     * 獲取當前監控的路徑
+     */
+    getWatched(): Record<string, string[]>;
+    /**
+     * 檢查是否正在監控
+     */
+    isWatching(): boolean;
+    /**
+     * 獲取監控路徑列表
+     */
+    getWatchedPaths(): string[];
+    /**
+     * 添加事件監聽器 (覆寫 EventEmitter 方法以提供型別安全)
+     */
+    on(event: 'change', listener: FileWatcherEventListener): this;
+    /**
+     * 移除事件監聽器 (覆寫 EventEmitter 方法以提供型別安全)
+     */
+    off(event: 'change', listener: FileWatcherEventListener): this;
+    /**
+     * 添加一次性事件監聽器
+     */
+    once(event: 'change', listener: FileWatcherEventListener): this;
+    /**
+     * 暫停監控（但不關閉 watcher）
+     */
+    pause(): void;
+    /**
+     * 恢復監控
+     */
+    resume(): void;
+    /**
+     * 設定去抖動延遲
+     */
+    setDebounceDelay(delay: number): void;
+    /**
+     * 獲取監控統計資訊
+     */
+    getStats(): {
+        watcherCount: number;
+        watchedPaths: number;
+        totalWatchedFiles: number;
+    };
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/infrastructure/storage/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/file-watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACL,YAAY,EAEZ,wBAAwB,EAEzB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAU7B;;IAOF;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DzE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAWtC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAI7D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAI/D;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,MAAM,IAAI,IAAI;IAWd;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASrC;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KACzB;CAUJ"}