agent-ide 0.1.7 → 0.1.9

package/dist/infrastructure/parser/base.js

@@ -2,7 +2,8 @@
  * BaseParserPlugin 抽象類別
  * 提供 Parser 插件的基礎實作和通用功能
  */
-import { isPosition } from '../../shared/types/index.js';
+import { minimatch } from 'minimatch';
+import { isPosition, SymbolType } from '../../shared/types/index.js';
 import { createValidationSuccess as createSuccessResult } from './types.js';
 /**
  * BaseParserPlugin 抽象類別
@@ -265,5 +266,61 @@ export class BaseParserPlugin {
             return defaultValue;
         }
     }
+    // ===== 檔案過濾支援 =====
+    /**
+     * 獲取預設的排除模式
+     * 子類可以 override 此方法提供語言特定的排除模式
+     */
+    getDefaultExcludePatterns() {
+        return [
+            'node_modules/**',
+            '.git/**',
+            'dist/**',
+            'build/**',
+            'coverage/**',
+            '.next/**',
+            '.nuxt/**',
+            'out/**',
+            '.cache/**',
+            '.turbo/**'
+        ];
+    }
+    /**
+     * 判斷是否應該忽略特定檔案
+     * 使用 minimatch 比對檔案路徑與排除模式
+     */
+    shouldIgnoreFile(filePath) {
+        const patterns = this.getDefaultExcludePatterns();
+        // 正規化路徑（移除開頭的 ./ 或 /）
+        const normalizedPath = filePath.replace(/^\.?\//, '');
+        // 檢查是否匹配任一排除模式
+        return patterns.some(pattern => {
+            try {
+                return minimatch(normalizedPath, pattern, { dot: true });
+            }
+            catch (error) {
+                this.log('warn', `無效的排除模式: ${pattern}`);
+                return false;
+            }
+        });
+    }
+    /**
+     * 判斷符號是否為抽象宣告
+     * 預設實作：class, interface, type, enum, function, module, namespace 視為抽象宣告
+     * 排除實體：variable, constant（這些是具體的值實例）
+     * 子類別可以覆寫此方法以實作語言特定的判斷邏輯
+     */
+    isAbstractDeclaration(symbol) {
+        const abstractTypes = [
+            SymbolType.Class,
+            SymbolType.Interface,
+            SymbolType.Type,
+            SymbolType.Enum,
+            SymbolType.Function,
+            SymbolType.Module,
+            SymbolType.Namespace
+        ];
+        return abstractTypes.includes(symbol.type);
+    }
 }
 //# sourceMappingURL=base.js.map

package/dist/infrastructure/parser/base.js.map

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

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

@@ -83,6 +83,26 @@ export interface ParserPlugin {
      * 應該釋放插件使用的所有資源
      */
     dispose(): Promise<void>;
+    /**
+     * 獲取預設的排除模式
+     * 每個語言可以定義自己特定的忽略規則
+     * @returns 排除模式列表（glob patterns）
+     */
+    getDefaultExcludePatterns?(): string[];
+    /**
+     * 判斷是否應該忽略特定檔案
+     * @param filePath 檔案路徑
+     * @returns true 表示應該忽略此檔案
+     */
+    shouldIgnoreFile?(filePath: string): boolean;
+    /**
+     * 判斷符號是否為抽象宣告
+     * 抽象宣告是指不產生實際執行程式碼的型別定義，如 class、interface、type、enum 等
+     * 各語言的抽象宣告定義不同，由各 Parser 實作
+     * @param symbol 要判斷的符號
+     * @returns true 表示此符號是抽象宣告
+     */
+    isAbstractDeclaration?(symbol: Symbol): boolean;
 }
 /**
  * Parser 插件型別守衛

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

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/parser/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAG3B,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,eAAe;IACf,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhD,cAAc;IACd,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAI/C;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpD;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAIrD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAIjE;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAIvD;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAsCpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAElF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,YAAY,GAAG,IAAI,CAUrB"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/parser/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAG3B,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,eAAe;IACf,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhD,cAAc;IACd,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAI/C;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpD;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAIrD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAIjE;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAIvD;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAIzB;;;;OAIG;IACH,yBAAyB,CAAC,IAAI,MAAM,EAAE,CAAC;IAEvC;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAI7C;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAyCpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAElF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,YAAY,GAAG,IAAI,CAUrB"}

package/dist/infrastructure/parser/interface.js

@@ -36,6 +36,8 @@ export function isParserPlugin(value) {
             return false;
         }
     }
+    // 可選方法不檢查（用於向後相容）
+    // getDefaultExcludePatterns 和 shouldIgnoreFile 是可選的
     return true;
 }
 /**

package/dist/infrastructure/parser/interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/infrastructure/parser/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6GH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,SAAS;IACT,IACE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EACtC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe;IACf,MAAM,eAAe,GAAG;QACtB,OAAO;QACP,gBAAgB;QAChB,gBAAgB;QAChB,qBAAqB;QACrB,QAAQ;QACR,iBAAiB;QACjB,gBAAgB;QAChB,YAAY;QACZ,UAAU;QACV,SAAS;KACV,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAoB,EAAE,SAAiB;IACvE,OAAQ,MAAM,CAAC,mBAAgC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,QAAgB;IACrE,OAAQ,MAAM,CAAC,kBAA+B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuB,EACvB,QAAgB;IAEhB,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/infrastructure/parser/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwIH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,SAAS;IACT,IACE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC5B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EACtC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe;IACf,MAAM,eAAe,GAAG;QACtB,OAAO;QACP,gBAAgB;QAChB,gBAAgB;QAChB,qBAAqB;QACrB,QAAQ;QACR,iBAAiB;QACjB,gBAAgB;QAChB,YAAY;QACZ,UAAU;QACV,SAAS;KACV,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,oDAAoD;IAEpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAoB,EAAE,SAAiB;IACvE,OAAQ,MAAM,CAAC,mBAAgC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,QAAgB;IACrE,OAAQ,MAAM,CAAC,kBAA+B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuB,EACvB,QAAgB;IAEhB,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/interfaces/cli/cli.d.ts

@@ -59,7 +59,15 @@ export declare class AgentIdeCLI {
      */
     private fileExists;
     /**
-     * 套用程式碼編輯
+     * 正確套用程式碼編輯
+     */
+    private applyEditCorrectly;
+    /**
+     * 將行列位置轉換為字元偏移量
+     */
+    private positionToOffset;
+    /**
+     * @deprecated 使用 applyEditCorrectly 代替
      */
     private applyCodeEdit;
     /**
@@ -70,5 +78,9 @@ export declare class AgentIdeCLI {
      * 讀取 tsconfig.json 的路徑別名設定
      */
     private loadPathAliases;
+    /**
+     * 建立輸出格式化器
+     */
+    private createFormatter;
 }
 //# sourceMappingURL=cli.d.ts.map

package/dist/interfaces/cli/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgCH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,aAAa,CAAC,CAAgB;;IAQtC;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,CAAC,iBAAiB;IAiDzB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,mBAAmB;YAuBb,kBAAkB;YA4BlB,mBAAmB;YAuHnB,qBAAqB;YAmFrB,iBAAiB;YA2EjB,mBAAmB;IAoEjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgD3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,cAAc;YAYR,oBAAoB;YAiLpB,iBAAiB;IAsG/B;;OAEG;YACW,yBAAyB;YAgBzB,wBAAwB;YA2BxB,uBAAuB;IAqBrC;;OAEG;YACW,UAAU;IASxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;YACW,kBAAkB;IAkChC;;OAEG;YACW,eAAe;CA+B9B"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiCH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,aAAa,CAAC,CAAgB;;IAQtC;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,CAAC,iBAAiB;IAiDzB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,mBAAmB;YAuBb,kBAAkB;YA2DlB,mBAAmB;YAuHnB,qBAAqB;YAuHrB,iBAAiB;YA2EjB,mBAAmB;IAoEjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgD3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,cAAc;YAYR,oBAAoB;YAiLpB,iBAAiB;IAsG/B;;OAEG;YACW,yBAAyB;YAgBzB,wBAAwB;YA2BxB,uBAAuB;IAqBrC;;OAEG;YACW,UAAU;IASxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;YACW,kBAAkB;IAkDhC;;OAEG;YACW,eAAe;IAgC7B;;OAEG;IACH,OAAO,CAAC,eAAe;CAqBxB"}

package/dist/interfaces/cli/cli.js

@@ -14,6 +14,7 @@ import { TypeScriptParser } from '../../plugins/typescript/parser.js';
 import { JavaScriptParser } from '../../plugins/javascript/parser.js';
 import { ComplexityAnalyzer } from '../../core/analysis/complexity-analyzer.js';
 import { DeadCodeDetector } from '../../core/analysis/dead-code-detector.js';
+import { OutputFormatter, OutputFormat } from './output-formatter.js';
 import * as fs from 'fs/promises';
 import { readFileSync } from 'fs';
 import * as path from 'path';
@@ -118,6 +119,7 @@ export class AgentIdeCLI {
             .option('-u, --update', '增量更新索引')
             .option('-e, --extensions <exts>', '包含的檔案副檔名', '.ts,.js,.tsx,.jsx')
             .option('-x, --exclude <patterns>', '排除模式', 'node_modules/**,*.test.*')
+            .option('--format <format>', '輸出格式 (markdown|plain|json|minimal)', 'plain')
             .action(async (options) => {
             await this.handleIndexCommand(options);
         });
@@ -133,6 +135,7 @@ export class AgentIdeCLI {
             .option('-o, --to <name>', '新名稱（--new-name 的別名）')
             .option('-p, --path <path>', '檔案或目錄路徑', '.')
             .option('--preview', '預覽變更而不執行')
+            .option('--format <format>', '輸出格式 (markdown|plain|json|minimal)', 'plain')
             .action(async (options) => {
             await this.handleRenameCommand(options);
         });
@@ -145,8 +148,10 @@ export class AgentIdeCLI {
             .option('-s, --start-line <line>', '起始行號')
             .option('-e, --end-line <line>', '結束行號')
             .option('-n, --function-name <name>', '函式名稱')
+            .option('-t, --target-file <file>', '目標檔案路徑（跨檔案提取）')
             .option('-p, --path <path>', '專案路徑', '.')
             .option('--preview', '預覽變更而不執行')
+            .option('--format <format>', '輸出格式 (markdown|plain|json|minimal)', 'plain')
             .action(async (action, options) => {
             await this.handleRefactorCommand(action, options);
         });
@@ -159,6 +164,7 @@ export class AgentIdeCLI {
             .argument('<target>', '目標路徑')
             .option('--update-imports', '自動更新 import 路徑', true)
             .option('--preview', '預覽變更而不執行')
+            .option('--format <format>', '輸出格式 (markdown|plain|json|minimal)', 'plain')
             .action(async (source, target, options) => {
             await this.handleMoveCommand(source, target, options);
         });
@@ -227,7 +233,12 @@ export class AgentIdeCLI {
     }
     // Command handlers
     async handleIndexCommand(options) {
-        console.log('🔍 開始建立程式碼索引...');
+        const formatter = this.createFormatter(options.format);
+        const startTime = Date.now();
+        if (options.format !== 'json' && options.format !== 'minimal') {
+            console.log(formatter.formatTitle('程式碼索引', 1));
+            console.log('\n🔍 開始建立程式碼索引...\n');
+        }
         try {
             const config = createIndexConfig(options.path, {
                 includeExtensions: options.extensions.split(','),
@@ -235,18 +246,43 @@ export class AgentIdeCLI {
             });
             this.indexEngine = new IndexEngine(config);
             if (options.update) {
-                // TODO: 實作增量更新
-                console.log('📝 執行增量索引更新...');
+                if (options.format !== 'json' && options.format !== 'minimal') {
+                    console.log('📝 執行增量索引更新...');
+                }
             }
             else {
                 await this.indexEngine.indexProject(options.path);
             }
             const stats = await this.indexEngine.getStats();
-            console.log('✅ 索引完成!');
-            console.log(`📊 統計: ${stats.totalFiles} 檔案, ${stats.totalSymbols} 符號`);
+            const duration = Date.now() - startTime;
+            const statsData = {
+                檔案數: stats.totalFiles,
+                符號數: stats.totalSymbols,
+                '執行時間(ms)': duration
+            };
+            if (options.format === 'json') {
+                console.log(formatter.formatSuccess('索引完成', statsData));
+            }
+            else if (options.format === 'minimal') {
+                console.log(`index:success files=${stats.totalFiles} symbols=${stats.totalSymbols} time=${duration}ms`);
+            }
+            else {
+                console.log('\n' + formatter.formatSuccess('索引完成'));
+                console.log('\n' + formatter.formatTitle('統計資訊', 2));
+                console.log(formatter.formatStats(statsData));
+            }
         }
         catch (error) {
-            console.error('❌ 索引失敗:', error instanceof Error ? error.message : error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (options.format === 'json') {
+                console.error(formatter.formatError(errorMessage));
+            }
+            else if (options.format === 'minimal') {
+                console.error(`index:error ${errorMessage}`);
+            }
+            else {
+                console.error('\n' + formatter.formatError(`索引失敗: ${errorMessage}`));
+            }
             if (process.env.NODE_ENV !== 'test') {
                 process.exit(1);
             }
@@ -393,18 +429,31 @@ export class AgentIdeCLI {
                 const { FunctionExtractor } = await import('../../core/refactor/extract-function.js');
                 const extractor = new FunctionExtractor();
                 // 執行提取
-                const result = await extractor.extract(code, range, {
+                const extractConfig = {
                     functionName: options.functionName,
                     generateComments: true,
                     preserveFormatting: true,
-                    validateExtraction: true
-                });
+                    validateExtraction: true,
+                    ...(options.targetFile ? {
+                        targetFile: path.resolve(options.targetFile),
+                        sourceFile: filePath
+                    } : {})
+                };
+                const result = await extractor.extract(code, range, extractConfig);
                 if (result.success) {
-                    // 套用編輯
+                    // 套用編輯（按正確順序）
                     let modifiedCode = code;
-                    result.edits.forEach(edit => {
-                        modifiedCode = this.applyCodeEdit(modifiedCode, edit);
-                    });
+                    // 先處理所有 insert 類型（在檔案開頭插入函式定義）
+                    const insertEdits = result.edits.filter(e => e.type === 'insert');
+                    const replaceEdits = result.edits.filter(e => e.type === 'replace');
+                    // 先應用 replace（替換選取範圍為函式呼叫）
+                    for (const edit of replaceEdits) {
+                        modifiedCode = this.applyEditCorrectly(modifiedCode, edit);
+                    }
+                    // 再應用 insert（插入函式定義）
+                    for (const edit of insertEdits) {
+                        modifiedCode = this.applyEditCorrectly(modifiedCode, edit);
+                    }
                     // 提取函式簽名（從修改後的程式碼中）
                     const functionSignatureMatch = modifiedCode.match(new RegExp(`(async\\s+)?function\\s+${result.functionName}\\s*\\([^)]*\\)`));
                     const functionSignature = functionSignatureMatch ? functionSignatureMatch[0] : `function ${result.functionName}`;
@@ -412,17 +461,35 @@ export class AgentIdeCLI {
                     console.log(`📝 提取的函式: ${functionSignature}`);
                     console.log(functionSignature);
                     if (!options.preview) {
-                        // 寫入檔案
+                        // 寫入原始檔案
                         await fs.writeFile(filePath, modifiedCode, 'utf-8');
                         console.log(`✓ 已更新 ${filePath}`);
+                        // 如果是跨檔案提取，寫入目標檔案
+                        if (result.targetFileContent && options.targetFile) {
+                            const targetPath = path.resolve(options.targetFile);
+                            // 確保目標目錄存在
+                            const targetDir = path.dirname(targetPath);
+                            await fs.mkdir(targetDir, { recursive: true });
+                            // 寫入目標檔案
+                            await fs.writeFile(targetPath, result.targetFileContent, 'utf-8');
+                            console.log(`✓ 已建立/更新目標檔案 ${targetPath}`);
+                            if (result.importStatement) {
+                                console.log(`✓ 已加入 import: ${result.importStatement}`);
+                            }
+                        }
                     }
                     else {
                         console.log('\n🔍 預覽模式 - 未寫入檔案');
                         console.log(`📊 參數: ${result.parameters.map(p => p.name).join(', ')}`);
+                        if (result.targetFileContent && options.targetFile) {
+                            console.log(`📁 目標檔案: ${options.targetFile}`);
+                            console.log(`📥 Import: ${result.importStatement || '(無)'}`);
+                        }
                     }
                 }
                 else {
                     console.error('❌ 重構失敗:', result.errors.join(', '));
+                    process.exitCode = 1;
                     if (process.env.NODE_ENV !== 'test') {
                         process.exit(1);
                     }
@@ -1010,7 +1077,43 @@ export class AgentIdeCLI {
         }
     }
     /**
-     * 套用程式碼編輯
+     * 正確套用程式碼編輯
+     */
+    applyEditCorrectly(code, edit) {
+        const lines = code.split('\n');
+        switch (edit.type) {
+            case 'replace': {
+                // 計算起始和結束位置的偏移量
+                const startOffset = this.positionToOffset(lines, edit.range.start);
+                const endOffset = this.positionToOffset(lines, edit.range.end);
+                return code.substring(0, startOffset) + edit.newText + code.substring(endOffset);
+            }
+            case 'insert': {
+                const offset = this.positionToOffset(lines, edit.range.start);
+                return code.substring(0, offset) + edit.newText + code.substring(offset);
+            }
+            case 'delete': {
+                const startOffset = this.positionToOffset(lines, edit.range.start);
+                const endOffset = this.positionToOffset(lines, edit.range.end);
+                return code.substring(0, startOffset) + code.substring(endOffset);
+            }
+            default:
+                return code;
+        }
+    }
+    /**
+     * 將行列位置轉換為字元偏移量
+     */
+    positionToOffset(lines, position) {
+        let offset = 0;
+        for (let i = 0; i < position.line - 1 && i < lines.length; i++) {
+            offset += lines[i].length + 1; // +1 for newline
+        }
+        offset += position.column;
+        return Math.min(offset, lines.join('\n').length);
+    }
+    /**
+     * @deprecated 使用 applyEditCorrectly 代替
      */
     applyCodeEdit(code, edit) {
         const lines = code.split('\n');
@@ -1029,6 +1132,21 @@ export class AgentIdeCLI {
         const files = [];
         const allowedExtensions = ['.ts', '.tsx', '.js', '.jsx'];
         const excludePatterns = ['node_modules', 'dist', '.git', 'coverage'];
+        // 檢查路徑是檔案還是目錄
+        try {
+            const stats = await fs.stat(projectPath);
+            if (stats.isFile()) {
+                // 如果是單一檔案，直接返回
+                if (allowedExtensions.some(ext => projectPath.endsWith(ext))) {
+                    return [projectPath];
+                }
+                return [];
+            }
+        }
+        catch (error) {
+            // 路徑不存在
+            return [];
+        }
         async function walkDir(dir) {
             try {
                 const entries = await fs.readdir(dir, { withFileTypes: true });
@@ -1087,5 +1205,27 @@ export class AgentIdeCLI {
         }
         return pathAliases;
     }
+    /**
+     * 建立輸出格式化器
+     */
+    createFormatter(format) {
+        let outputFormat;
+        switch (format?.toLowerCase()) {
+            case 'markdown':
+                outputFormat = OutputFormat.Markdown;
+                break;
+            case 'json':
+                outputFormat = OutputFormat.Json;
+                break;
+            case 'minimal':
+                outputFormat = OutputFormat.Minimal;
+                break;
+            case 'plain':
+            default:
+                outputFormat = OutputFormat.Plain;
+                break;
+        }
+        return new OutputFormatter(outputFormat);
+    }
 }
 //# sourceMappingURL=cli.js.map