agent-ide 0.2.0 → 0.3.3

package/dist/core/snapshot/index.d.ts

@@ -1,23 +1,7 @@
 /**
  * Snapshot 模組統一匯出
- * 提供程式碼快照生成、壓縮、增量更新等功能
  */
-import { SnapshotEngine as SnapshotEngineClass } from './snapshot-engine.js';
-import { ConfigManager as ConfigManagerClass } from './config.js';
-export { SnapshotEngine } from './snapshot-engine.js';
-export { CodeCompressor } from './code-compressor.js';
-export { SnapshotDiffer } from './snapshot-differ.js';
-export { ConfigManager } from './config.js';
-export type { Snapshot, SnapshotOptions, SnapshotStats, SnapshotDiff, ModuleSummary, CompressedSymbol, CompressedCode, QualityMetrics, FileChange } from './types.js';
-export { CompressionLevel, FileChangeType } from './types.js';
-export type { ProjectConfig, ProjectConfig as SnapshotConfig } from './config.js';
-export { createDefaultSnapshotOptions, isSnapshot, estimateSnapshotTokens } from './types.js';
-/**
- * 建立快照引擎的便利函式
- */
-export declare function createSnapshotEngine(): SnapshotEngineClass;
-/**
- * 建立配置管理器的便利函式
- */
-export declare function createConfigManager(): ConfigManagerClass;
+export { SnapshotGenerator } from './snapshot-generator.js';
+export type { ModuleSnapshot, ProjectSnapshot, SnapshotResult, PrivateInfo, SnapshotOptions } from './types.js';
+export { SnapshotScope, isProjectSnapshot, isModuleSnapshot } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/snapshot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,YAAY,EACV,QAAQ,EACR,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlF,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,CAE1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,CAExD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/snapshot/index.js

@@ -1,27 +1,6 @@
 /**
  * Snapshot 模組統一匯出
- * 提供程式碼快照生成、壓縮、增量更新等功能
  */
-import { SnapshotEngine as SnapshotEngineClass } from './snapshot-engine.js';
-import { ConfigManager as ConfigManagerClass } from './config.js';
-// 核心類別
-export { SnapshotEngine } from './snapshot-engine.js';
-export { CodeCompressor } from './code-compressor.js';
-export { SnapshotDiffer } from './snapshot-differ.js';
-export { ConfigManager } from './config.js';
-export { CompressionLevel, FileChangeType } from './types.js';
-// 工廠函式和工具函式
-export { createDefaultSnapshotOptions, isSnapshot, estimateSnapshotTokens } from './types.js';
-/**
- * 建立快照引擎的便利函式
- */
-export function createSnapshotEngine() {
-    return new SnapshotEngineClass();
-}
-/**
- * 建立配置管理器的便利函式
- */
-export function createConfigManager() {
-    return new ConfigManagerClass();
-}
+export { SnapshotGenerator } from './snapshot-generator.js';
+export { SnapshotScope, isProjectSnapshot, isModuleSnapshot } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/core/snapshot/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO;AACP,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc5C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG9D,YAAY;AACZ,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,mBAAmB,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAQ5D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/snapshot/snapshot-generator.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Snapshot 產生器
+ * 分析模組產生 AI 可讀的快照
+ */
+import type { IFileSystem } from '../../infrastructure/storage/index.js';
+import type { SnapshotResult } from './types.js';
+/**
+ * Snapshot 產生器
+ */
+export declare class SnapshotGenerator {
+    private readonly fileSystem;
+    constructor(fileSystem: IFileSystem);
+    /**
+     * 產生快照
+     */
+    generate(targetPath: string): Promise<SnapshotResult>;
+    /**
+     * 偵測範圍（module 或 project）
+     */
+    private detectScope;
+    /**
+     * 產生模組快照
+     */
+    private generateModuleSnapshot;
+    /**
+     * 產生專案快照
+     */
+    private generateProjectSnapshot;
+    /**
+     * 找出所有模組目錄（有 index.ts 的目錄）
+     */
+    private findModuleDirs;
+    /**
+     * 建構模組快照
+     */
+    private buildModuleSnapshot;
+    /**
+     * 取得 class 的方法
+     */
+    private getClassMethods;
+    /**
+     * 取得 class 的私有欄位
+     */
+    private getClassFields;
+    /**
+     * 格式化方法簽章
+     */
+    private formatMethodSignature;
+    /**
+     * 格式化函數簽章
+     */
+    private formatFunctionSignature;
+    /**
+     * 簡化簽章格式（移除函數名稱，保留參數和回傳型別）
+     */
+    private simplifySignature;
+    /**
+     * 格式化 interface 欄位
+     */
+    private formatInterfaceFields;
+    /**
+     * 格式化 type alias
+     */
+    private formatTypeAlias;
+}
+//# sourceMappingURL=snapshot-generator.d.ts.map

package/dist/core/snapshot/snapshot-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-generator.d.ts","sourceRoot":"","sources":["../../../src/core/snapshot/snapshot-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpE,OAAO,KAAK,EAAmC,cAAc,EAAe,MAAM,YAAY,CAAC;AAS/F;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;gBAE7B,UAAU,EAAE,WAAW;IAInC;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAU3D;;OAEG;YACW,WAAW;IA0BzB;;OAEG;YACW,sBAAsB;IAqBpC;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;YACW,cAAc;IA8B5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,eAAe;CAMxB"}

package/dist/core/snapshot/snapshot-generator.js

@@ -0,0 +1,258 @@
+/**
+ * Snapshot 產生器
+ * 分析模組產生 AI 可讀的快照
+ */
+import * as path from 'path';
+import { IndexEngine, createIndexConfig } from '../indexing/index.js';
+import { SymbolType } from '../../shared/types/index.js';
+import { SnapshotScope } from './types.js';
+/**
+ * Snapshot 產生器
+ */
+export class SnapshotGenerator {
+    fileSystem;
+    constructor(fileSystem) {
+        this.fileSystem = fileSystem;
+    }
+    /**
+     * 產生快照
+     */
+    async generate(targetPath) {
+        const scope = await this.detectScope(targetPath);
+        if (scope === SnapshotScope.Project) {
+            return this.generateProjectSnapshot(targetPath);
+        }
+        return this.generateModuleSnapshot(targetPath);
+    }
+    /**
+     * 偵測範圍（module 或 project）
+     */
+    async detectScope(targetPath) {
+        // 檢查是否有 package.json（專案根目錄）
+        const packageJsonPath = path.join(targetPath, 'package.json');
+        const hasPackageJson = await this.fileSystem.exists(packageJsonPath);
+        if (hasPackageJson) {
+            // 檢查是否有 src 目錄（表示是專案）
+            const srcPath = path.join(targetPath, 'src');
+            const hasSrc = await this.fileSystem.exists(srcPath);
+            if (hasSrc) {
+                return SnapshotScope.Project;
+            }
+        }
+        // 檢查是否有 index.ts（模組入口）
+        const indexPath = path.join(targetPath, 'index.ts');
+        const hasIndex = await this.fileSystem.exists(indexPath);
+        if (hasIndex) {
+            return SnapshotScope.Module;
+        }
+        // 預設為模組
+        return SnapshotScope.Module;
+    }
+    /**
+     * 產生模組快照
+     */
+    async generateModuleSnapshot(modulePath) {
+        const config = createIndexConfig(modulePath, {
+            includeExtensions: ['.ts', '.js', '.tsx', '.jsx', '.swift', '.py'],
+            excludePatterns: ['node_modules/**', '**/*.test.ts', '**/*.spec.ts', '**/test_*.py', '**/*_test.py']
+        });
+        const indexEngine = new IndexEngine(config, this.fileSystem);
+        try {
+            await indexEngine.indexProject();
+            const allSymbols = await indexEngine.getAllSymbols();
+            const symbols = allSymbols.map(result => result.symbol);
+            const relativePath = path.basename(modulePath);
+            return this.buildModuleSnapshot(relativePath, symbols, modulePath);
+        }
+        finally {
+            indexEngine.dispose();
+        }
+    }
+    /**
+     * 產生專案快照
+     */
+    async generateProjectSnapshot(projectPath) {
+        const projectName = path.basename(projectPath);
+        const modules = {};
+        // 找出所有模組目錄
+        const srcPath = path.join(projectPath, 'src');
+        const modulesDirs = await this.findModuleDirs(srcPath);
+        for (const moduleDir of modulesDirs) {
+            const moduleSnapshot = await this.generateModuleSnapshot(moduleDir);
+            const relativePath = path.relative(projectPath, moduleDir);
+            modules[relativePath] = moduleSnapshot;
+        }
+        return {
+            project: projectName,
+            modules
+        };
+    }
+    /**
+     * 找出所有模組目錄（有 index.ts 的目錄）
+     */
+    async findModuleDirs(basePath) {
+        const moduleDirs = [];
+        const processDir = async (dirPath) => {
+            const exists = await this.fileSystem.exists(dirPath);
+            if (!exists) {
+                return;
+            }
+            const entries = await this.fileSystem.readDirectory(dirPath);
+            // 檢查是否有 index.ts
+            const hasIndex = entries.some(entry => entry.name === 'index.ts' || entry.name === 'index.js');
+            if (hasIndex) {
+                moduleDirs.push(dirPath);
+            }
+            // 遞迴處理子目錄
+            for (const entry of entries) {
+                if (entry.isDirectory && !entry.name.startsWith('.')) {
+                    await processDir(path.join(dirPath, entry.name));
+                }
+            }
+        };
+        await processDir(basePath);
+        return moduleDirs;
+    }
+    /**
+     * 建構模組快照
+     */
+    buildModuleSnapshot(moduleName, symbols, _modulePath) {
+        // 轉型為 ExtendedSymbol 以存取 signature 和 typeInfo
+        const extendedSymbols = symbols;
+        const api = {};
+        const factories = {};
+        const types = {};
+        const privateInfo = {};
+        // 分類符號
+        const classes = extendedSymbols.filter(s => s.type === SymbolType.Class);
+        const functions = extendedSymbols.filter(s => s.type === SymbolType.Function);
+        const interfaces = extendedSymbols.filter(s => s.type === SymbolType.Interface);
+        const typeAliases = extendedSymbols.filter(s => s.type === SymbolType.Type);
+        // 處理 class
+        for (const cls of classes) {
+            const methods = this.getClassMethods(cls, extendedSymbols);
+            if (Object.keys(methods).length > 0) {
+                api[cls.name] = methods;
+            }
+            // 提取私有資訊
+            const fields = this.getClassFields(cls, extendedSymbols);
+            if (fields.length > 0) {
+                privateInfo[cls.name] = {
+                    fields,
+                    imports: ''
+                };
+            }
+        }
+        // 處理 factory 函數（createXxx）
+        for (const func of functions) {
+            if (func.name.startsWith('create')) {
+                factories[func.name] = this.formatFunctionSignature(func);
+            }
+        }
+        // 處理 interface
+        for (const iface of interfaces) {
+            types[iface.name] = this.formatInterfaceFields(iface, extendedSymbols);
+        }
+        // 處理 type alias
+        for (const typeAlias of typeAliases) {
+            types[typeAlias.name] = this.formatTypeAlias(typeAlias);
+        }
+        return {
+            module: moduleName,
+            api,
+            factories,
+            types,
+            private: privateInfo
+        };
+    }
+    /**
+     * 取得 class 的方法
+     */
+    getClassMethods(cls, allSymbols) {
+        const methods = {};
+        // 找出屬於此 class 的方法
+        // 方法的 scope 是 function scope（方法名），其 parent 才是 class scope
+        const classMethods = allSymbols.filter(s => s.type === SymbolType.Function
+            && (s.scope?.parent?.name === cls.name || s.scope?.name === cls.name)
+            && !s.modifiers.includes('private')
+            && s.name !== 'constructor' // 排除 constructor
+        );
+        for (const method of classMethods) {
+            methods[method.name] = this.formatMethodSignature(method);
+        }
+        return methods;
+    }
+    /**
+     * 取得 class 的私有欄位
+     */
+    getClassFields(cls, allSymbols) {
+        const fields = [];
+        // 找出屬於此 class 的屬性
+        const classProps = allSymbols.filter(s => (s.type === SymbolType.Property || s.type === SymbolType.Variable)
+            && s.scope?.name === cls.name);
+        for (const prop of classProps) {
+            fields.push(prop.name);
+        }
+        return fields;
+    }
+    /**
+     * 格式化方法簽章
+     */
+    formatMethodSignature(method) {
+        // 優先使用 Parser 提取的完整簽章
+        if (method.signature) {
+            return this.simplifySignature(method.signature);
+        }
+        return '() → unknown';
+    }
+    /**
+     * 格式化函數簽章
+     */
+    formatFunctionSignature(func) {
+        // 優先使用 Parser 提取的完整簽章
+        if (func.signature) {
+            return this.simplifySignature(func.signature);
+        }
+        return '() → unknown';
+    }
+    /**
+     * 簡化簽章格式（移除函數名稱，保留參數和回傳型別）
+     */
+    simplifySignature(signature) {
+        // 格式：name<T>(param: Type): ReturnType → (param: Type) → ReturnType
+        const match = signature.match(/^[^(]*\(([^)]*)\)(?:\s*:\s*(.+))?$/);
+        if (match) {
+            const params = match[1].trim();
+            const returnType = match[2]?.trim() || 'void';
+            return params ? `(${params}) → ${returnType}` : `() → ${returnType}`;
+        }
+        return signature;
+    }
+    /**
+     * 格式化 interface 欄位
+     */
+    formatInterfaceFields(iface, allSymbols) {
+        // 找出屬於此 interface 的屬性
+        const props = allSymbols.filter(s => (s.type === SymbolType.Property || s.type === SymbolType.Variable)
+            && s.scope?.name === iface.name);
+        if (props.length === 0) {
+            return '{}';
+        }
+        // 包含型別資訊
+        const fields = props.map(p => {
+            const typeInfo = p.typeInfo ? `: ${p.typeInfo}` : '';
+            return `${p.name}${typeInfo}`;
+        });
+        return `{${fields.join(', ')}}`;
+    }
+    /**
+     * 格式化 type alias
+     */
+    formatTypeAlias(typeAlias) {
+        if (typeAlias.typeInfo) {
+            return typeAlias.typeInfo;
+        }
+        return '{}';
+    }
+}
+//# sourceMappingURL=snapshot-generator.js.map

package/dist/core/snapshot/snapshot-generator.js.map

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

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

@@ -1,216 +1,67 @@
 /**
  * Snapshot 模組型別定義
- * 提供程式碼快照相關的型別和介面
+ * 定義模組快照的結構，供 AI 快速理解程式碼
  */
 /**
- * 壓縮層級
+ * 模組快照結構
+ * 包含 API、factories、types、private 資訊
  */
-export declare enum CompressionLevel {
-    /** 最小化：只包含架構和符號索引 (~20K tokens) */
-    Minimal = "minimal",
-    /** 中等：包含符號和簡化的實作 (~35K tokens) */
-    Medium = "medium",
-    /** 完整：包含壓縮後的完整實作 (~50K tokens) */
-    Full = "full"
-}
-/**
- * 快照配置選項
- */
-export interface SnapshotOptions {
-    /** 專案根目錄路徑 */
-    projectPath: string;
-    /** 輸出檔案路徑 */
-    outputPath?: string;
-    /** 壓縮層級 */
-    level?: CompressionLevel;
-    /** 是否使用增量更新 */
-    incremental?: boolean;
-    /** 排除模式（glob patterns） */
-    exclude?: string[];
-    /** 包含的檔案副檔名 */
-    extensions?: string[];
-    /** 是否包含測試檔案 */
-    includeTests?: boolean;
-    /** 是否生成多層級快照 */
-    multiLevel?: boolean;
-    /** 多層級輸出目錄 */
-    outputDir?: string;
-    /** 是否靜默模式（不輸出進度訊息） */
-    silent?: boolean;
-}
-/**
- * 模組摘要
- */
-export interface ModuleSummary {
+export interface ModuleSnapshot {
     /** 模組路徑 */
-    p: string;
-    /** 匯出符號數量 */
-    e: number;
-    /** 依賴數量 */
-    d: number;
-    /** 程式碼行數 */
-    l: number;
-}
-/**
- * 壓縮的符號資訊
- */
-export interface CompressedSymbol {
-    /** 符號名稱 */
-    n: string;
-    /** 符號類型（縮寫：f=function, c=class, v=variable, i=interface, t=type, e=enum） */
-    t: string;
-    /** 起始行號 */
-    s: number;
-    /** 結束行號 */
-    e: number;
-    /** 是否匯出 */
-    x?: boolean;
-    /** 簽章（函式/方法） */
-    sg?: string;
-    /** 父符號（巢狀符號） */
-    p?: string;
-}
-/**
- * 壓縮的程式碼
- */
-export interface CompressedCode {
-    /** 壓縮後的程式碼 */
-    m: string;
-    /** 符號映射表（縮短變數名的映射） */
-    sm?: Record<string, string>;
-    /** 原始行數 */
-    ol?: number;
-    /** 壓縮後行數 */
-    cl?: number;
-}
-/**
- * 品質指標
- */
-export interface QualityMetrics {
-    /** ShitScore 分數 */
-    ss: number;
-    /** 複雜度 */
-    cx: number;
-    /** 可維護性 */
-    mt: number;
-    /** 關鍵問題列表 */
-    is: string[];
+    readonly module: string;
+    /** 公開 API（class → method → 簽章） */
+    readonly api: Record<string, Record<string, string>>;
+    /** 工廠函數（createXxx） */
+    readonly factories: Record<string, string>;
+    /** 型別定義（interface/type） */
+    readonly types: Record<string, string>;
+    /** 私有資訊（class → fields/imports） */
+    readonly private: Record<string, PrivateInfo>;
 }
 /**
- * 檔案變更類型
+ * 專案快照結構（多模組）
  */
-export declare enum FileChangeType {
-    Added = "added",
-    Modified = "modified",
-    Deleted = "deleted"
-}
-/**
- * 檔案變更記錄
- */
-export interface FileChange {
-    /** 檔案路徑 */
-    path: string;
-    /** 變更類型 */
-    type: FileChangeType;
-    /** 舊 hash（修改或刪除時） */
-    oldHash?: string;
-    /** 新 hash（新增或修改時） */
-    newHash?: string;
+export interface ProjectSnapshot {
+    /** 專案名稱 */
+    readonly project: string;
+    /** 各模組快照 */
+    readonly modules: Record<string, ModuleSnapshot>;
 }
 /**
- * 快照結構
+ * 私有資訊結構
  */
-export interface Snapshot {
-    /** 快照格式版本 */
-    v: string;
-    /** 專案名稱 */
-    p: string;
-    /** 生成時間戳 */
-    t: number;
-    /** 專案狀態 hash */
-    h: string;
-    /** 壓縮層級 */
-    l: CompressionLevel;
-    /** 架構層 */
-    s: {
-        /** 目錄列表 */
-        d: string[];
-        /** 模組摘要 */
-        m: ModuleSummary[];
-    };
-    /** 符號索引 */
-    y: Record<string, CompressedSymbol[]>;
-    /** 依賴關係 */
-    dp: {
-        /** 依賴邊列表 [from, to] */
-        g: [string, string][];
-        /** 檔案的 import 列表 */
-        i: Record<string, string[]>;
-        /** 檔案的 export 列表 */
-        ex: Record<string, string[]>;
-    };
-    /** 程式碼內容 */
-    c: Record<string, CompressedCode>;
-    /** 品質指標 */
-    q: QualityMetrics;
-    /** 增量更新元數據 */
-    md: {
-        /** 檔案 hash 映射 */
-        fh: Record<string, string>;
-        /** 總檔案數 */
-        tf: number;
-        /** 總程式碼行數 */
-        tl: number;
-        /** 使用的語言 */
-        lg: string[];
-    };
+export interface PrivateInfo {
+    /** 私有欄位列表 */
+    readonly fields: readonly string[];
+    /** import 來源 */
+    readonly imports: string;
 }
 /**
- * 快照差異
+ * 快照範圍
  */
-export interface SnapshotDiff {
-    /** 新增的檔案 */
-    added: string[];
-    /** 修改的檔案 */
-    modified: string[];
-    /** 刪除的檔案 */
-    deleted: string[];
-    /** 變更摘要 */
-    summary: {
-        totalChanges: number;
-        filesAffected: number;
-        linesChanged: number;
-    };
+export declare enum SnapshotScope {
+    Module = "module",
+    Project = "project"
 }
 /**
- * 快照統計資訊
+ * 快照選項
  */
-export interface SnapshotStats {
-    /** 檔案數量 */
-    fileCount: number;
-    /** 總程式碼行數 */
-    totalLines: number;
-    /** 符號總數 */
-    symbolCount: number;
-    /** 依賴關係數 */
-    dependencyCount: number;
-    /** 估計 token 數 */
-    estimatedTokens: number;
-    /** 壓縮比例 */
-    compressionRatio: number;
-    /** 生成耗時（毫秒） */
-    generationTime: number;
+export interface SnapshotOptions {
+    /** 目標路徑 */
+    readonly path: string;
+    /** 輸出格式 */
+    readonly format: 'json' | 'summary';
 }
 /**
- * 建立預設的快照選項
+ * 快照結果（可能是單一模組或專案）
  */
-export declare function createDefaultSnapshotOptions(projectPath: string): SnapshotOptions;
+export type SnapshotResult = ModuleSnapshot | ProjectSnapshot;
 /**
- * 型別守衛：檢查是否為有效的快照
+ * 型別守衛：是否為 ProjectSnapshot
  */
-export declare function isSnapshot(value: unknown): value is Snapshot;
+export declare function isProjectSnapshot(result: SnapshotResult): result is ProjectSnapshot;
 /**
- * 計算快照大小（估計 token 數）
+ * 型別守衛：是否為 ModuleSnapshot
  */
-export declare function estimateSnapshotTokens(snapshot: Snapshot): number;
+export declare function isModuleSnapshot(result: SnapshotResult): result is ModuleSnapshot;
 //# sourceMappingURL=types.d.ts.map