@mycodemap/mycodemap 0.4.1 → 0.5.0

package/dist/ai/provider.d.ts

@@ -0,0 +1,70 @@
+import type { CodeMap } from '../types/index.js';
+/**
+ * AI Provider 配置
+ */
+export interface AIProviderConfig {
+    /** 超时时间（毫秒） */
+    timeout?: number;
+    /** 最大 token 数 */
+    maxTokens?: number;
+    /** 模型版本 */
+    model?: string;
+}
+/**
+ * AI 响应结果
+ */
+export interface AIResponse {
+    /** 响应内容 */
+    content: string;
+    /** 使用的模型 */
+    model?: string;
+    /** 消耗的 token 数 */
+    usage?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+}
+/**
+ * AI Provider 基类
+ * 所有 AI Provider 都应继承此类
+ */
+export declare abstract class AIProvider {
+    /** Provider 名称 */
+    abstract readonly name: string;
+    /** 默认配置 */
+    protected config: AIProviderConfig;
+    constructor(config?: AIProviderConfig);
+    /**
+     * 执行 AI 推理
+     * @param prompt 提示词
+     * @param context 上下文数据（CodeMap）
+     */
+    abstract execute(prompt: string, context?: CodeMap): Promise<AIResponse>;
+    /**
+     * 检查 Provider 是否可用
+     */
+    abstract isAvailable(): Promise<boolean>;
+    /**
+     * 获取 Provider 类型
+     */
+    getProviderType(): string;
+    /**
+     * 销毁 Provider（可选实现）
+     */
+    destroy(): void;
+}
+/**
+ * Provider 类型枚举
+ */
+export type ProviderType = 'claude' | 'codex' | 'openai' | 'gemini';
+/**
+ * Provider 工厂配置
+ */
+export interface ProviderFactoryConfig {
+    /** 使用的 Provider 类型 */
+    provider?: ProviderType;
+    /** Provider 配置 */
+    config?: AIProviderConfig;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/ai/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;;GAGG;AACH,8BAAsB,UAAU;IAC9B,kBAAkB;IAClB,kBAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,WAAW;IACX,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAEvB,MAAM,GAAE,gBAAqB;IAQzC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAExE;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAExC;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,kBAAkB;IAClB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B"}

package/dist/ai/provider.js

@@ -0,0 +1,31 @@
+// ============================================
+// AI Provider 基础类型定义
+// ============================================
+/**
+ * AI Provider 基类
+ * 所有 AI Provider 都应继承此类
+ */
+export class AIProvider {
+    /** 默认配置 */
+    config;
+    constructor(config = {}) {
+        this.config = {
+            timeout: 60000, // 默认 60 秒
+            maxTokens: 4000,
+            ...config
+        };
+    }
+    /**
+     * 获取 Provider 类型
+     */
+    getProviderType() {
+        return this.name;
+    }
+    /**
+     * 销毁 Provider（可选实现）
+     */
+    destroy() {
+        // 默认空实现，子类可覆盖
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/ai/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAgC/C;;;GAGG;AACH,MAAM,OAAgB,UAAU;IAI9B,WAAW;IACD,MAAM,CAAmB;IAEnC,YAAY,SAA2B,EAAE;QACvC,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,KAAK,EAAE,UAAU;YAC1B,SAAS,EAAE,IAAI;YACf,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAcD;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,cAAc;IAChB,CAAC;CACF"}

package/dist/ai/subagent-caller.d.ts

@@ -0,0 +1,90 @@
+import type { CodeMap } from '../types/index.js';
+/**
+ * Subagent 输入类型
+ */
+export interface SubagentInput {
+    project: CodeMap['project'];
+    summary: CodeMap['summary'];
+    modules: CodeMap['modules'];
+    dependencies: CodeMap['dependencies'];
+    requestType: 'overview' | 'analysis' | 'documentation';
+    options: {
+        includeContext: boolean;
+        maxModules: number;
+    };
+}
+/**
+ * 架构信息
+ */
+export interface ArchitectureInfo {
+    pattern: string;
+    layers: Array<{
+        name: string;
+        responsibility: string;
+        modules: string[];
+    }>;
+    metrics: {
+        coupling: 'low' | 'medium' | 'high';
+        cohesion: 'low' | 'medium' | 'high';
+        complexity: 'low' | 'medium' | 'high';
+    };
+}
+/**
+ * Subagent 输出类型
+ */
+export interface SubagentOutput {
+    type: string;
+    title: string;
+    content: string;
+    highlights: string[];
+    architecture?: ArchitectureInfo;
+    metadata: {
+        generatedAt: string;
+        model: string;
+    };
+}
+/**
+ * Subagent Caller 配置
+ */
+export interface SubagentCallerConfig {
+    /** CLI 路径 */
+    cliPath?: string;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+    /** 子 agent 名称 */
+    subagentName?: string;
+}
+/**
+ * Subagent Caller - 通过 Claude CLI 调用 subagent
+ */
+export declare class SubagentCaller {
+    private cliPath;
+    private timeout;
+    private subagentName;
+    constructor(config?: SubagentCallerConfig);
+    /**
+     * 调用 subagent 生成项目概述
+     */
+    generateOverview(codeMap: CodeMap): Promise<SubagentOutput>;
+    /**
+     * 构建调用 subagent 的 prompt
+     */
+    private buildPrompt;
+    /**
+     * 执行 CLI 调用
+     */
+    private execute;
+    /**
+     * 解析 subagent 输出
+     */
+    private parseOutput;
+    /**
+     * 检查 CLI 是否可用
+     */
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * 创建默认的 SubagentCaller 实例
+ */
+export declare function createSubagentCaller(config?: SubagentCallerConfig): SubagentCaller;
+//# sourceMappingURL=subagent-caller.d.ts.map

package/dist/ai/subagent-caller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-caller.d.ts","sourceRoot":"","sources":["../../src/ai/subagent-caller.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACtC,WAAW,EAAE,UAAU,GAAG,UAAU,GAAG,eAAe,CAAC;IACvD,OAAO,EAAE;QACP,cAAc,EAAE,OAAO,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,EAAE;QACP,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACpC,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KACvC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,GAAE,oBAAyB;IAQ7C;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BjE;;OAEG;IACH,OAAO,CAAC,WAAW;IAkGnB;;OAEG;IACH,OAAO,CAAC,OAAO;IAyDf;;OAEG;IACH,OAAO,CAAC,WAAW;IAwDnB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAqBtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,cAAc,CAElF"}

package/dist/ai/subagent-caller.js

@@ -0,0 +1,280 @@
+// ============================================
+// Subagent Caller - Task 工具调用封装
+// ============================================
+import { spawn } from 'child_process';
+/**
+ * Subagent Caller - 通过 Claude CLI 调用 subagent
+ */
+export class SubagentCaller {
+    cliPath;
+    timeout;
+    subagentName;
+    constructor(config = {}) {
+        this.cliPath = config.cliPath || 'claude';
+        this.timeout = config.timeout || 120000; // 默认 2 分钟
+        this.subagentName = config.subagentName || 'ai-generator';
+        // 使用 subagentName 构建提示词（用于日志或调试）
+        void this.subagentName;
+    }
+    /**
+     * 调用 subagent 生成项目概述
+     */
+    async generateOverview(codeMap) {
+        // 准备输入数据
+        const input = {
+            project: codeMap.project,
+            summary: {
+                totalFiles: codeMap.summary.totalFiles,
+                totalModules: codeMap.summary.totalModules,
+                totalExports: codeMap.summary.totalExports,
+                totalTypes: codeMap.summary.totalTypes,
+                totalLines: codeMap.summary.totalLines
+            },
+            modules: codeMap.modules.slice(0, 20), // 限制数量
+            dependencies: codeMap.dependencies,
+            requestType: 'overview',
+            options: {
+                includeContext: true,
+                maxModules: 20
+            }
+        };
+        // 构建 prompt
+        const prompt = this.buildPrompt(input);
+        // 调用 CLI
+        const result = await this.execute(prompt);
+        // 解析输出
+        return this.parseOutput(result);
+    }
+    /**
+     * 构建调用 subagent 的 prompt
+     */
+    buildPrompt(input) {
+        const contextJson = JSON.stringify(input, null, 2);
+        return `# AI Generator Subagent
+
+你是 AI Generator Subagent，负责根据 CodeMap 数据生成专业的项目概述。
+
+## 角色定义
+
+你是一位专业的软件架构师，擅长分析 TypeScript/JavaScript 项目结构，识别架构模式，并提供有价值的见解。
+
+## 输入数据
+
+\`\`\`json
+${contextJson}
+\`\`\`
+
+## 任务
+
+根据上述 CodeMap 数据，生成一个专业的项目概述，需要包含以下内容：
+
+### 1. 项目概览
+- 项目名称和基本信息
+- 技术栈识别
+- 总体架构描述
+
+### 2. 统计信息
+- 文件总数、代码行数、模块数量
+- 导出符号数量和类型分布
+
+### 3. 核心模块分析
+- 最重要的 5-10 个模块及其职责
+- 每个模块的关键导出
+- 模块间的依赖关系
+
+### 4. 架构特点
+- 识别的架构模式（如分层、DDD、微服务等）
+- 各层的职责和边界
+- 依赖方向和耦合度
+
+### 5. 亮点模块
+- 值得注意的模块或设计模式
+- 可能的创新点或最佳实践
+
+### 6. 建议（可选）
+- 潜在的改进方向
+- 架构优化建议
+
+## 输出格式
+
+请返回 JSON 格式的结果，包含以下字段：
+
+\`\`\`json
+{
+  "type": "overview",
+  "title": "项目概述标题",
+  "content": "Markdown 格式的详细描述（支持多级标题、列表、表格等）",
+  "highlights": ["亮点1", "亮点2", ...],
+  "architecture": {
+    "pattern": "识别的架构模式",
+    "layers": [
+      {
+        "name": "层名称",
+        "responsibility": "职责描述",
+        "modules": ["模块列表"]
+      }
+    ],
+    "metrics": {
+      "coupling": "low|medium|high",
+      "cohesion": "low|medium|high",
+      "complexity": "low|medium|high"
+    }
+  },
+  "metadata": {
+    "generatedAt": "ISO 时间戳",
+    "model": "sonnet"
+  }
+}
+\`\`\`
+
+## 输出指南
+
+1. **准确性**: 确保分析基于实际数据，不要臆造信息
+2. **专业性**: 使用标准的软件架构术语
+3. **简洁性**: 保持内容简洁但完整，突出重点
+4. **可读性**: 使用 Markdown 格式提高可读性
+5. **实用性**: 提供有价值的架构见解和建议
+
+## 注意事项
+
+- 如果某些信息无法从输入数据中确定，请标注为"未识别"或"需要更多信息"
+- 优先分析依赖关系最复杂的模块
+- 关注导出数量多、被依赖次数多的核心模块
+
+请确保返回的是有效的 JSON 格式，不要包含其他文字说明。
+`;
+    }
+    /**
+     * 执行 CLI 调用
+     */
+    execute(prompt) {
+        return new Promise((resolve, reject) => {
+            const args = [
+                '-p',
+                '--output-format', 'json',
+                '--dangerously-skip-permissions'
+            ];
+            let stdout = '';
+            let stderr = '';
+            let killed = false;
+            const proc = spawn(this.cliPath, args, {
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+            // 超时处理
+            const timeoutId = setTimeout(() => {
+                killed = true;
+                proc.kill('SIGTERM');
+                reject(new Error(`Subagent 执行超时（${this.timeout / 1000}秒）`));
+            }, this.timeout);
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timeoutId);
+                if (killed)
+                    return;
+                if (code !== 0 && code !== null) {
+                    reject(new Error(`Subagent CLI 错误: ${stderr || `exit code ${code}`}`));
+                    return;
+                }
+                resolve(stdout);
+            });
+            proc.on('error', (error) => {
+                clearTimeout(timeoutId);
+                if (!killed) {
+                    reject(new Error(`Subagent CLI 执行失败: ${error.message}`));
+                }
+            });
+            // 发送提示词
+            proc.stdin.write(prompt);
+            proc.stdin.end();
+        });
+    }
+    /**
+     * 解析 subagent 输出
+     */
+    parseOutput(stdout) {
+        // Claude 可能输出多行 JSON，需要找到有效的 JSON
+        const lines = stdout.trim().split('\n');
+        let jsonStr = '';
+        // 从后往前找有效的 JSON 对象
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const line = lines[i].trim();
+            if (line.startsWith('{') && line.endsWith('}')) {
+                jsonStr = line;
+                break;
+            }
+        }
+        if (!jsonStr) {
+            // 如果没有 JSON，返回默认格式
+            return {
+                type: 'overview',
+                title: '项目概述',
+                content: stdout.trim(),
+                highlights: [],
+                metadata: {
+                    generatedAt: new Date().toISOString(),
+                    model: 'unknown'
+                }
+            };
+        }
+        try {
+            const parsed = JSON.parse(jsonStr);
+            return {
+                type: parsed.type || 'overview',
+                title: parsed.title || '项目概述',
+                content: parsed.content || stdout.trim(),
+                highlights: parsed.highlights || [],
+                architecture: parsed.architecture,
+                metadata: {
+                    generatedAt: parsed.metadata?.generatedAt || new Date().toISOString(),
+                    model: parsed.metadata?.model || 'sonnet'
+                }
+            };
+        }
+        catch (error) {
+            // 解析失败，返回原始内容
+            return {
+                type: 'overview',
+                title: '项目概述',
+                content: stdout.trim(),
+                highlights: [],
+                metadata: {
+                    generatedAt: new Date().toISOString(),
+                    model: 'parse-error'
+                }
+            };
+        }
+    }
+    /**
+     * 检查 CLI 是否可用
+     */
+    async isAvailable() {
+        return new Promise((resolve) => {
+            const proc = spawn(this.cliPath, ['--version'], {
+                stdio: 'ignore'
+            });
+            proc.on('close', (code) => {
+                resolve(code === 0);
+            });
+            proc.on('error', () => {
+                resolve(false);
+            });
+            // 2 秒超时
+            setTimeout(() => {
+                proc.kill();
+                resolve(false);
+            }, 2000);
+        });
+    }
+}
+/**
+ * 创建默认的 SubagentCaller 实例
+ */
+export function createSubagentCaller(config) {
+    return new SubagentCaller(config);
+}
+//# sourceMappingURL=subagent-caller.js.map

package/dist/ai/subagent-caller.js.map

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

package/dist/ai/types.d.ts

@@ -0,0 +1,70 @@
+export interface AIProviderOptions {
+    /** Provider 名称 */
+    name: string;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+    /** 最大重试次数 */
+    maxRetries?: number;
+    /** 是否启用调试模式 */
+    debug?: boolean;
+    /** 自定义环境变量 */
+    env?: Record<string, string>;
+}
+export interface ChatRequest {
+    /** 提示词 */
+    prompt: string;
+    /** 额外上下文 */
+    context?: Record<string, unknown>;
+    /** 系统提示词 */
+    systemPrompt?: string;
+    /** 最大令牌数 */
+    maxTokens?: number;
+    /** 温度参数 */
+    temperature?: number;
+}
+export interface ChatResponse {
+    /** 响应内容 */
+    content: string;
+    /** 使用的 provider */
+    provider: string;
+    /** 消耗的令牌数 */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** 响应时间（毫秒） */
+    latency: number;
+}
+export interface ProviderStatus {
+    /** Provider 名称 */
+    name: string;
+    /** 是否可用 */
+    isAvailable: boolean;
+    /** 检查时间 */
+    checkedAt: string;
+    /** 错误信息（如果不可用） */
+    error?: string;
+}
+export type ProviderType = 'claude' | 'codex';
+export interface ProviderInfo {
+    /** Provider 类型 */
+    type: ProviderType;
+    /** 显示名称 */
+    displayName: string;
+    /** 描述 */
+    description: string;
+    /** CLI 命令 */
+    command: string;
+    /** 默认参数 */
+    defaultArgs: string[];
+}
+export interface CLIResult {
+    /** 退出码 */
+    exitCode: number;
+    /** 标准输出 */
+    stdout: string;
+    /** 标准错误 */
+    stderr: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAGD,MAAM,WAAW,WAAW;IAC1B,UAAU;IACV,MAAM,EAAE,MAAM,CAAC;IACf,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAG9C,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAGD,MAAM,WAAW,SAAS;IACxB,UAAU;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/ai/types.js

@@ -0,0 +1,5 @@
+// ============================================
+// AI Provider 类型定义
+// ============================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C"}

package/dist/cli/commands/analyze-options.d.ts

@@ -0,0 +1,36 @@
+/**
+ * [META] since:2026-03-24 | owner:cli-team | stable:false
+ * [WHY] 统一 analyze 的 option schema，减少 commander/help/parse 三处事实漂移
+ */
+import type { ParseArgsConfig } from 'node:util';
+import { Command } from 'commander';
+type AnalyzeParseOption = {
+    type: 'string' | 'boolean';
+    short?: string;
+    multiple?: boolean;
+    default?: boolean;
+};
+interface AnalyzeOptionDefinition {
+    name: string;
+    flags: string;
+    description: string;
+    helpDescription: string;
+    docDescription?: string;
+    docDefaultValue?: string;
+    parse: AnalyzeParseOption;
+    defaultValue?: string;
+    includeInCommander?: boolean;
+    includeInDocs?: boolean;
+}
+export declare const ANALYZE_COMMAND_DESCRIPTION = "\u7EDF\u4E00\u5206\u6790\u5165\u53E3 - \u652F\u6301\u591A\u79CD\u5206\u6790\u610F\u56FE";
+export declare const ANALYZE_OPTION_DEFINITIONS: readonly AnalyzeOptionDefinition[];
+export declare const ANALYZE_PARSE_OPTIONS: NonNullable<ParseArgsConfig["options"]>;
+export declare function applyAnalyzeCliOptions(command: Command): Command;
+export declare function configureAnalyzeCommand(command: Command): Command;
+export declare function renderAnalyzeHelpOptions(): string;
+export declare const ANALYZE_HELP_EXAMPLES: readonly ["codemap analyze -i find -k \"SourceLocation\" --json --structured", "codemap analyze -i read -t src/index.ts --scope transitive --json", "codemap analyze -i link -t src/utils --json", "codemap analyze -i show -t src/ --output-mode human"];
+export declare function renderAnalyzeHelpExamples(): string;
+export declare function renderAnalyzeAfterHelpText(): string;
+export declare function getAnalyzeHelpText(programName?: string): string;
+export {};
+//# sourceMappingURL=analyze-options.d.ts.map

package/dist/cli/commands/analyze-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-options.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze-options.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,2BAA2B,4FAAsB,CAAC;AAE/D,eAAO,MAAM,0BAA0B,EAAE,SAAS,uBAAuB,EA8F/D,CAAC;AAEX,eAAO,MAAM,qBAAqB,EAE7B,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAE7C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAehE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAIjE;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAUjD;AAED,eAAO,MAAM,qBAAqB,2PAKxB,CAAC;AAEX,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,MAAoB,GAAG,MAAM,CAO5E"}