agent-ide 0.1.0

package/dist/core/search/types.d.ts

@@ -0,0 +1,357 @@
+/**
+ * Search 模組型別定義
+ * 定義搜尋相關的所有介面和型別
+ */
+import type { Range } from '../../shared/types/index.js';
+import type { Symbol, SymbolType } from '../../shared/types/index.js';
+/**
+ * 搜尋結果
+ */
+export interface SearchResult {
+    /** 匹配項目列表 */
+    matches: Match[];
+    /** 總匹配數量 */
+    totalCount: number;
+    /** 搜尋耗時（毫秒） */
+    searchTime: number;
+    /** 結果是否被截斷 */
+    truncated: boolean;
+}
+/**
+ * 單個匹配項目
+ */
+export interface Match {
+    /** 檔案路徑 */
+    file: string;
+    /** 行號 */
+    line: number;
+    /** 欄位 */
+    column: number;
+    /** 匹配內容 */
+    content: string;
+    /** 匹配上下文 */
+    context: MatchContext;
+    /** 相關性分數 */
+    score: number;
+    /** 匹配長度 */
+    length: number;
+    /** 匹配範圍 */
+    range: Range;
+}
+/**
+ * 匹配上下文
+ */
+export interface MatchContext {
+    /** 前幾行內容 */
+    before: string[];
+    /** 後幾行內容 */
+    after: string[];
+    /** 所在函式名稱 */
+    function?: string;
+    /** 所在類別名稱 */
+    class?: string;
+    /** 所在作用域 */
+    scope?: string;
+}
+/**
+ * 基礎搜尋選項
+ */
+export interface SearchOptions {
+    /** 搜尋範圍 */
+    scope: SearchScope;
+    /** 包含的檔案模式 */
+    includeFiles?: string[];
+    /** 排除的檔案模式 */
+    excludeFiles?: string[];
+    /** 最大結果數量 */
+    maxResults?: number;
+    /** 搜尋超時時間（毫秒） */
+    timeout?: number;
+    /** 是否使用索引 */
+    useIndex?: boolean;
+    /** 是否顯示上下文 */
+    showContext?: boolean;
+    /** 上下文行數 */
+    contextLines?: number;
+}
+/**
+ * 文字搜尋選項
+ */
+export interface TextSearchOptions extends SearchOptions {
+    /** 大小寫敏感 */
+    caseSensitive?: boolean;
+    /** 全字匹配 */
+    wholeWord?: boolean;
+    /** 正則表達式 */
+    regex?: boolean;
+    /** 多行匹配 */
+    multiline?: boolean;
+    /** 模糊匹配 */
+    fuzzy?: boolean;
+    /** 反向搜尋（排除） */
+    invert?: boolean;
+}
+/**
+ * 符號搜尋選項
+ */
+export interface SymbolSearchOptions extends SearchOptions {
+    /** 符號類型過濾 */
+    symbolTypes?: SymbolType[];
+    /** 修飾符過濾 */
+    modifiers?: string[];
+    /** 是否包含私有符號 */
+    includePrivate?: boolean;
+    /** 是否包含測試檔案 */
+    includeTests?: boolean;
+}
+/**
+ * 模式搜尋選項
+ */
+export interface PatternSearchOptions extends SearchOptions {
+    /** 目標語言 */
+    language?: string;
+    /** 是否深度匹配 */
+    deepMatch?: boolean;
+}
+/**
+ * 搜尋範圍
+ */
+export interface SearchScope {
+    /** 範圍類型 */
+    type: 'file' | 'directory' | 'project' | 'workspace';
+    /** 路徑 */
+    path?: string;
+    /** 是否遞迴 */
+    recursive?: boolean;
+    /** 最大深度 */
+    maxDepth?: number;
+}
+/**
+ * 基礎查詢
+ */
+export interface SearchQuery {
+    /** 搜尋類型 */
+    type: SearchType;
+    /** 查詢字串 */
+    query: string;
+    /** 搜尋選項 */
+    options?: SearchOptions;
+}
+/**
+ * 文字查詢
+ */
+export interface TextQuery extends SearchQuery {
+    type: 'text';
+    options?: TextSearchOptions;
+}
+/**
+ * 符號查詢
+ */
+export interface SymbolQuery extends SearchQuery {
+    type: 'symbol';
+    /** 符號名稱 */
+    name?: string;
+    /** 符號類型 */
+    symbolType?: SymbolType;
+    /** 修飾符 */
+    modifiers?: string[];
+    /** 搜尋範圍 */
+    scope?: SearchScope;
+    options?: SymbolSearchOptions;
+}
+/**
+ * 程式碼模式查詢
+ */
+export interface CodePattern {
+    /** 模式類型 */
+    type: 'ast' | 'regex' | 'template';
+    /** 模式內容 */
+    pattern: string | ASTPattern;
+    /** 語言 */
+    language?: string;
+}
+/**
+ * AST 模式
+ */
+export interface ASTPattern {
+    /** 節點類型 */
+    nodeType: string;
+    /** 節點屬性 */
+    properties?: Record<string, any>;
+    /** 子節點模式 */
+    children?: ASTPattern[];
+}
+/**
+ * 模式查詢
+ */
+export interface PatternQuery extends SearchQuery {
+    type: 'pattern';
+    /** 程式碼模式 */
+    pattern: CodePattern;
+    options?: PatternSearchOptions;
+}
+/**
+ * 搜尋類型枚舉
+ */
+export declare const SearchType: {
+    readonly TEXT: "text";
+    readonly SYMBOL: "symbol";
+    readonly PATTERN: "pattern";
+    readonly SEMANTIC: "semantic";
+    readonly REGEX: "regex";
+};
+export type SearchType = typeof SearchType[keyof typeof SearchType];
+/**
+ * 符號搜尋結果
+ */
+export interface SymbolSearchResult extends SearchResult {
+    /** 找到的符號列表 */
+    symbols: Symbol[];
+    /** 按類型分組的符號 */
+    symbolsByType: Map<SymbolType, Symbol[]>;
+}
+/**
+ * 語義搜尋結果
+ */
+export interface SemanticSearchResult extends SearchResult {
+    /** 搜尋建議 */
+    suggestions: string[];
+    /** 相關符號 */
+    relatedSymbols: Symbol[];
+    /** 信心度 */
+    confidence: number;
+}
+/**
+ * 模式搜尋結果
+ */
+export interface PatternSearchResult extends SearchResult {
+    /** 匹配的 AST 節點 */
+    nodes: PatternMatch[];
+}
+/**
+ * 模式匹配項目
+ */
+export interface PatternMatch extends Match {
+    /** 匹配的 AST 節點 */
+    node: any;
+    /** 節點路徑 */
+    nodePath: string[];
+}
+/**
+ * 批次搜尋結果
+ */
+export interface BatchSearchResult {
+    /** 各個搜尋的結果 */
+    results: SearchResult[];
+    /** 總耗時 */
+    totalTime: number;
+    /** 是否全部成功 */
+    allSucceeded: boolean;
+}
+/**
+ * 搜尋建議
+ */
+export interface SearchSuggestion {
+    /** 建議文字 */
+    text: string;
+    /** 建議類型 */
+    type: 'completion' | 'correction' | 'history' | 'context';
+    /** 相關性分數 */
+    score: number;
+    /** 描述 */
+    description?: string;
+}
+/**
+ * 搜尋上下文
+ */
+export interface SearchContext {
+    /** 當前檔案 */
+    currentFile?: string;
+    /** 當前符號 */
+    currentSymbol?: Symbol;
+    /** 最近搜尋 */
+    recentSearches?: string[];
+    /** 工作目錄 */
+    workingDirectory?: string;
+}
+/**
+ * 搜尋錯誤
+ */
+export declare class SearchError extends Error {
+    readonly code: SearchErrorCode;
+    readonly query?: string | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: SearchErrorCode, query?: string | undefined, cause?: Error | undefined);
+}
+/**
+ * 搜尋錯誤代碼
+ */
+export declare enum SearchErrorCode {
+    QUERY_PARSE_ERROR = "QUERY_PARSE_ERROR",
+    SEARCH_TIMEOUT = "SEARCH_TIMEOUT",
+    INDEX_NOT_AVAILABLE = "INDEX_NOT_AVAILABLE",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    PATTERN_INVALID = "PATTERN_INVALID",
+    REGEX_INVALID = "REGEX_INVALID",
+    MEMORY_EXCEEDED = "MEMORY_EXCEEDED"
+}
+/**
+ * 搜尋索引介面
+ */
+export interface SearchIndex {
+    /** 索引名稱 */
+    name: string;
+    /** 是否準備就緒 */
+    ready: boolean;
+    /** 最後更新時間 */
+    lastUpdated: Date;
+    /** 索引大小（檔案數量） */
+    size: number;
+}
+/**
+ * 全文索引
+ */
+export interface FullTextIndex extends SearchIndex {
+    /** 搜尋文字 */
+    search(query: string, options?: TextSearchOptions): Promise<Match[]>;
+    /** 添加文件 */
+    addDocument(filePath: string, content: string): Promise<void>;
+    /** 移除文件 */
+    removeDocument(filePath: string): Promise<void>;
+    /** 更新文件 */
+    updateDocument(filePath: string, content: string): Promise<void>;
+}
+/**
+ * 符號索引
+ */
+export interface SymbolIndex extends SearchIndex {
+    /** 搜尋符號 */
+    searchSymbols(query: SymbolQuery): Promise<Symbol[]>;
+    /** 添加符號 */
+    addSymbols(filePath: string, symbols: Symbol[]): Promise<void>;
+    /** 移除符號 */
+    removeSymbols(filePath: string): Promise<void>;
+}
+/**
+ * 搜尋統計
+ */
+export interface SearchStats {
+    /** 總搜尋次數 */
+    totalSearches: number;
+    /** 平均搜尋時間 */
+    averageSearchTime: number;
+    /** 快取命中率 */
+    cacheHitRate: number;
+    /** 最常搜尋的查詢 */
+    topQueries: Array<{
+        query: string;
+        count: number;
+    }>;
+    /** 最近搜尋 */
+    recentSearches: Array<{
+        query: string;
+        timestamp: Date;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/search/types.d.ts.map

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

package/dist/core/search/types.js

@@ -0,0 +1,47 @@
+/**
+ * Search 模組型別定義
+ * 定義搜尋相關的所有介面和型別
+ */
+// ===== 搜尋類型 =====
+/**
+ * 搜尋類型枚舉
+ */
+// 搜尋類型枚舉
+export const SearchType = {
+    TEXT: 'text',
+    SYMBOL: 'symbol',
+    PATTERN: 'pattern',
+    SEMANTIC: 'semantic',
+    REGEX: 'regex' // 新增 REGEX 類型
+};
+// ===== 錯誤處理 =====
+/**
+ * 搜尋錯誤
+ */
+export class SearchError extends Error {
+    code;
+    query;
+    cause;
+    constructor(message, code, query, cause) {
+        super(message);
+        this.code = code;
+        this.query = query;
+        this.cause = cause;
+        this.name = 'SearchError';
+    }
+}
+/**
+ * 搜尋錯誤代碼
+ */
+export var SearchErrorCode;
+(function (SearchErrorCode) {
+    SearchErrorCode["QUERY_PARSE_ERROR"] = "QUERY_PARSE_ERROR";
+    SearchErrorCode["SEARCH_TIMEOUT"] = "SEARCH_TIMEOUT";
+    SearchErrorCode["INDEX_NOT_AVAILABLE"] = "INDEX_NOT_AVAILABLE";
+    SearchErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    SearchErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    SearchErrorCode["PATTERN_INVALID"] = "PATTERN_INVALID";
+    SearchErrorCode["REGEX_INVALID"] = "REGEX_INVALID";
+    SearchErrorCode["MEMORY_EXCEEDED"] = "MEMORY_EXCEEDED";
+})(SearchErrorCode || (SearchErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/core/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/search/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqNH,mBAAmB;AAEnB;;GAEG;AACH,SAAS;AACT,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO,CAAC,cAAc;CACrB,CAAC;AA0FX,mBAAmB;AAEnB;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IACA;IACA;IAJlB,YACE,OAAe,EACC,IAAqB,EACrB,KAAc,EACd,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAiB;QACrB,UAAK,GAAL,KAAK,CAAS;QACd,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eASX;AATD,WAAY,eAAe;IACzB,0DAAuC,CAAA;IACvC,oDAAiC,CAAA;IACjC,8DAA2C,CAAA;IAC3C,oDAAiC,CAAA;IACjC,0DAAuC,CAAA;IACvC,sDAAmC,CAAA;IACnC,kDAA+B,CAAA;IAC/B,sDAAmC,CAAA;AACrC,CAAC,EATW,eAAe,KAAf,eAAe,QAS1B"}

package/dist/infrastructure/cache/cache-manager.d.ts

@@ -0,0 +1,113 @@
+import { MemoryCache } from './memory-cache.js';
+import { type CacheOptions, type CacheManagerOptions, type CacheEventListener } from './types.js';
+/**
+ * 全域統計資訊
+ */
+export interface GlobalStats {
+    /** 總快取數量 */
+    totalCaches: number;
+    /** 總項目數量 */
+    totalItems: number;
+    /** 總請求次數 */
+    totalRequests: number;
+    /** 總命中次數 */
+    totalHits: number;
+    /** 總未命中次數 */
+    totalMisses: number;
+    /** 全域命中率 */
+    globalHitRate: number;
+    /** 總記憶體使用量 */
+    totalMemoryUsage: number;
+    /** 總淘汰次數 */
+    totalEvictions: number;
+    /** 總過期次數 */
+    totalExpirations: number;
+}
+/**
+ * 批次操作結果
+ */
+export interface BatchOperationResult {
+    /** 成功處理的項目 */
+    successful: string[];
+    /** 失敗的項目 */
+    failed: string[];
+}
+/**
+ * 快取管理器 - 管理多個快取實例
+ */
+export declare class CacheManager {
+    private readonly caches;
+    private readonly options;
+    private readonly globalEventListeners;
+    private disposed;
+    constructor(options?: CacheManagerOptions);
+    /**
+     * 建立新的快取實例
+     */
+    createCache<K, V>(name: string, options?: CacheOptions): MemoryCache<K, V>;
+    /**
+     * 取得現有的快取實例
+     */
+    getCache<K, V>(name: string): MemoryCache<K, V> | undefined;
+    /**
+     * 檢查快取是否存在
+     */
+    hasCache(name: string): boolean;
+    /**
+     * 刪除快取實例
+     */
+    deleteCache(name: string): boolean;
+    /**
+     * 批次刪除快取實例
+     */
+    deleteCaches(names: string[]): BatchOperationResult;
+    /**
+     * 列出所有快取名稱
+     */
+    listCaches(): string[];
+    /**
+     * 清空指定快取的內容
+     */
+    clearCache(name: string): boolean;
+    /**
+     * 批次清空多個快取的內容
+     */
+    clearCaches(names: string[]): void;
+    /**
+     * 清空所有快取的內容
+     */
+    clearAll(): void;
+    /**
+     * 預熱快取
+     */
+    warmupCache(name: string): Promise<void>;
+    /**
+     * 取得全域統計資訊
+     */
+    getGlobalStats(): GlobalStats;
+    /**
+     * 添加全域事件監聽器
+     */
+    addGlobalEventListener(listener: CacheEventListener<any, any>): void;
+    /**
+     * 移除全域事件監聽器
+     */
+    removeGlobalEventListener(listener: CacheEventListener<any, any>): void;
+    /**
+     * 銷毀管理器和所有快取
+     */
+    dispose(): void;
+    /**
+     * 取得管理器配置
+     */
+    getOptions(): Readonly<CacheManagerOptions>;
+    /**
+     * 檢查管理器是否已被銷毀
+     */
+    private checkDisposed;
+    /**
+     * 處理快取事件（用於全域統計和事件轉發）
+     */
+    private handleCacheEvent;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/infrastructure/cache/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cache/cache-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAExB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA2C;IAChF,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,mBAAwB;IAsB7C;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAwBpB;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS;IAK3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK/B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWlC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,oBAAoB;IAiBnD;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAKtB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUjC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAQlC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC9C;;OAEG;IACH,cAAc,IAAI,WAAW;IAmD7B;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAKpE;;OAEG;IACH,yBAAyB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAKvE;;OAEG;IACH,OAAO,IAAI,IAAI;IAaf;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,mBAAmB,CAAC;IAM3C;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}