@mycodemap/mycodemap 1.9.0 → 2.7.0

package/dist/execution/contract-tools/analyze.js

@@ -0,0 +1,1215 @@
+/**
+ * [META] AnalyzeCommand - 统一分析入口
+ * [WHY] 为 CI 与人工调用提供统一分析输出，支持 machine/json 契约
+ */
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import chalk from 'chalk';
+import { ImpactCommand } from '../../cli/commands/impact.js';
+import { DepsCommand } from '../../cli/commands/deps.js';
+import { ComplexityCommand } from '../../cli/commands/complexity.js';
+import { ANALYZE_PARSE_OPTIONS } from '../../cli/commands/analyze-options.js';
+import { PUBLIC_INTENTS, calculateConfidenceLevel } from '../../orchestrator/types.js';
+import { resolveTestFile } from '../../orchestrator/test-linker.js';
+import { ToolOrchestrator } from '../../orchestrator/tool-orchestrator.js';
+import { ResultFusion } from '../../orchestrator/result-fusion.js';
+import { CodemapAdapter } from '../../orchestrator/adapters/codemap-adapter.js';
+import { AstGrepAdapter } from '../../orchestrator/adapters/ast-grep-adapter.js';
+import { IntentRouter } from '../../orchestrator/intent-router.js';
+import { resolveDataPath, resolveOutputDir } from '../../cli/paths.js';
+import { discoverProjectFiles } from '../../core/file-discovery.js';
+import { loadCodemapConfig } from '../../cli/config-loader.js';
+import { createContractError, createContractSuccess, normalizeExecutionError, } from './types.js';
+/**
+ * 错误码定义
+ */
+export var AnalyzeErrorCode;
+(function (AnalyzeErrorCode) {
+    /** E0001: 无效 intent 值 */
+    AnalyzeErrorCode["E0001_INVALID_INTENT"] = "E0001";
+    /** E0002: 缺少必要参数 */
+    AnalyzeErrorCode["E0002_MISSING_REQUIRED_PARAM"] = "E0002";
+    /** E0003: 目标路径不存在 */
+    AnalyzeErrorCode["E0003_TARGET_NOT_FOUND"] = "E0003";
+    /** E0004: 工具执行超时 */
+    AnalyzeErrorCode["E0004_EXECUTION_TIMEOUT"] = "E0004";
+    /** E0005: 工具执行失败 */
+    AnalyzeErrorCode["E0005_EXECUTION_FAILED"] = "E0005";
+    /** E0006: 置信度过低 */
+    AnalyzeErrorCode["E0006_LOW_CONFIDENCE"] = "E0006";
+})(AnalyzeErrorCode || (AnalyzeErrorCode = {}));
+/**
+ * 错误信息映射
+ */
+export const ERROR_MESSAGES = {
+    [AnalyzeErrorCode.E0001_INVALID_INTENT]: '无效的 intent 参数值',
+    [AnalyzeErrorCode.E0002_MISSING_REQUIRED_PARAM]: '缺少必要参数',
+    [AnalyzeErrorCode.E0003_TARGET_NOT_FOUND]: '目标路径不存在',
+    [AnalyzeErrorCode.E0004_EXECUTION_TIMEOUT]: '工具执行超时',
+    [AnalyzeErrorCode.E0005_EXECUTION_FAILED]: '工具执行失败',
+    [AnalyzeErrorCode.E0006_LOW_CONFIDENCE]: '置信度过低',
+};
+/**
+ * 支持的 intent 列表
+ */
+export const VALID_INTENTS = [
+    ...PUBLIC_INTENTS,
+];
+/**
+ * AnalyzeCommand 分析命令类
+ */
+export class AnalyzeCommand {
+    args;
+    /**
+     * 构造函数
+     * @param args 分析命令参数
+     */
+    constructor(args) {
+        this.args = args;
+    }
+    /**
+     * 验证参数
+     * @throws AnalyzeError 当参数无效时
+     */
+    validate() {
+        if (!this.args.intent) {
+            throw this.createError(AnalyzeErrorCode.E0002_MISSING_REQUIRED_PARAM, '缺少必要参数: intent');
+        }
+        const intentRouter = new IntentRouter();
+        // 验证 intent
+        if (!intentRouter.isValidIntent(this.args.intent)) {
+            throw this.createError(AnalyzeErrorCode.E0001_INVALID_INTENT, `无效的 intent: ${this.args.intent}。支持的选项: ${VALID_INTENTS.join(', ')}`);
+        }
+        const routedIntent = intentRouter.route(this.args);
+        const normalizedIntent = routedIntent.intent;
+        const hasTargets = Boolean(this.args.targets && this.args.targets.length > 0);
+        const hasKeywords = Boolean(this.args.keywords && this.args.keywords.length > 0);
+        if (normalizedIntent === 'find') {
+            if (!hasTargets && !hasKeywords) {
+                throw this.createError(AnalyzeErrorCode.E0002_MISSING_REQUIRED_PARAM, '缺少必要参数: targets 或 keywords');
+            }
+            return;
+        }
+        if (normalizedIntent === 'link' &&
+            routedIntent.compatibility?.normalizedFrom === 'reference' &&
+            hasKeywords) {
+            return;
+        }
+        if (!hasTargets) {
+            throw this.createError(AnalyzeErrorCode.E0002_MISSING_REQUIRED_PARAM, '缺少必要参数: targets');
+        }
+    }
+    /**
+     * 创建错误对象
+     */
+    createError(code, message) {
+        const error = new Error(`[${code}] ${message}`);
+        error.code = code;
+        return error;
+    }
+    /**
+     * 执行分析
+     */
+    async execute() {
+        this.validate();
+        const intentRouter = new IntentRouter();
+        const intentObj = intentRouter.route(this.args);
+        const scope = intentObj.scope;
+        const topK = this.args.topK || 8;
+        switch (intentObj.intent) {
+            case 'read':
+                return this.executeRead(intentObj, scope, topK);
+            case 'link':
+                return this.executeLink(intentObj, topK);
+            case 'show':
+                return this.executeShow(intentObj, topK);
+            case 'find':
+                return this.executeFindWithFallback(intentObj, topK);
+            default:
+                throw this.createError(AnalyzeErrorCode.E0001_INVALID_INTENT, `无效的 intent: ${intentObj.intent}`);
+        }
+    }
+    /**
+     * `find` 优先走 orchestrator，失败时回退到 AstGrep 搜索
+     */
+    async executeFindWithFallback(intentObj, topK) {
+        try {
+            const orchestratedOutput = await this.executeWithOrchestrator(intentObj, topK);
+            if (orchestratedOutput.results.length > 0) {
+                return this.withCompatibility(this.withDiagnostics(orchestratedOutput, this.createSuccessDiagnostics()), intentObj.compatibility);
+            }
+            try {
+                await this.executeFind(intentObj, topK, { failOnScanError: true });
+            }
+            catch (scanError) {
+                return this.withCompatibility(await this.executeConfigAwareTextFallback(intentObj, topK, scanError, undefined), intentObj.compatibility);
+            }
+            return this.withCompatibility(this.withDiagnostics(orchestratedOutput, this.createSuccessDiagnostics()), intentObj.compatibility);
+        }
+        catch (orchestratorError) {
+            console.warn('[Analyze] Orchestrator not available, falling back to AstGrep search');
+            try {
+                return await this.executeFind(intentObj, topK, { failOnScanError: true });
+            }
+            catch (scanError) {
+                return this.withCompatibility(await this.executeConfigAwareTextFallback(intentObj, topK, scanError, orchestratorError), intentObj.compatibility);
+            }
+        }
+    }
+    /**
+     * 使用编排器执行分析
+     */
+    async executeWithOrchestrator(intentObj, topK) {
+        const orchestrator = new ToolOrchestrator();
+        // 注册适配器
+        const codemapAdapter = new CodemapAdapter({ codemapPath: resolveOutputDir().outputDir });
+        const astGrepAdapter = new AstGrepAdapter({ includeTests: this.args.includeTests ?? true });
+        orchestrator.registerAdapter(codemapAdapter);
+        orchestrator.registerAdapter(astGrepAdapter);
+        const fusion = new ResultFusion();
+        const effectiveIntent = intentObj.executionIntent ?? intentObj.intent;
+        let orchestratedResults = [];
+        let confidence;
+        if (intentObj.secondary) {
+            const tools = Array.from(new Set([intentObj.tool, intentObj.secondary]));
+            const resultsByTool = await orchestrator.executeParallel(intentObj, tools);
+            orchestratedResults = fusion.fuse(resultsByTool, {
+                topK,
+                intent: effectiveIntent,
+                keywordWeights: {},
+                maxTokens: 160,
+            });
+            const confidenceScore = this.calculateConfidence(orchestratedResults);
+            confidence = {
+                score: confidenceScore,
+                level: confidenceScore >= 0.7 ? 'high' : confidenceScore >= 0.4 ? 'medium' : 'low',
+            };
+        }
+        else {
+            const result = await orchestrator.executeWithFallback(intentObj, intentObj.tool);
+            orchestratedResults = result.results.slice(0, topK);
+            confidence = {
+                score: result.confidence?.score || 0,
+                level: result.confidence?.level || 'low',
+            };
+        }
+        // 为结果添加 location 字段
+        const resultsWithLocation = this.enrichWithLocation(orchestratedResults);
+        return {
+            schemaVersion: 'v1.0.0',
+            intent: intentObj.intent,
+            tool: 'codemap-orchestrated',
+            confidence,
+            results: resultsWithLocation,
+            metadata: {
+                total: orchestratedResults.length,
+                scope: intentObj.scope,
+                resultCount: orchestratedResults.length,
+            },
+        };
+    }
+    /**
+     * 为输出添加兼容期 warning
+     */
+    withCompatibility(output, compatibility) {
+        const warnings = this.buildCompatibilityWarnings(compatibility);
+        if (warnings.length === 0) {
+            return output;
+        }
+        return {
+            ...output,
+            warnings
+        };
+    }
+    /**
+     * 生成结构化兼容 warning
+     */
+    buildCompatibilityWarnings(compatibility) {
+        if (!compatibility?.isDeprecated || !compatibility.normalizedFrom) {
+            return [];
+        }
+        const replacementIntent = compatibility.normalizedFrom === 'search'
+            ? 'find'
+            : compatibility.normalizedFrom === 'impact' || compatibility.normalizedFrom === 'complexity'
+                ? 'read'
+                : compatibility.normalizedFrom === 'dependency' || compatibility.normalizedFrom === 'reference'
+                    ? 'link'
+                    : 'show';
+        return [{
+                code: 'deprecated-intent',
+                severity: 'warning',
+                message: `legacy intent "${compatibility.normalizedFrom}" 已弃用，请改用 "${replacementIntent}"`,
+                deprecatedIntent: compatibility.normalizedFrom,
+                replacementIntent,
+                sunsetPolicy: '2-minor-window'
+            }];
+    }
+    /**
+     * find fallback
+     */
+    async executeFind(intentObj, topK, options = {}) {
+        const searchTerms = intentObj.keywords.length > 0 ? intentObj.keywords : intentObj.targets;
+        const adapter = new AstGrepAdapter({
+            includeTests: this.args.includeTests ?? true,
+            failOnScanError: options.failOnScanError ?? false
+        });
+        const rawResults = await adapter.execute(searchTerms, {
+            topK,
+            includeTests: this.args.includeTests,
+            keywords: searchTerms
+        });
+        const results = this.enrichWithLocation(rawResults).slice(0, topK);
+        const confidence = this.buildConfidence(this.calculateConfidence(results));
+        return this.withCompatibility({
+            schemaVersion: 'v1.0.0',
+            intent: 'find',
+            tool: 'ast-grep-find',
+            confidence,
+            results,
+            diagnostics: this.createSuccessDiagnostics(),
+            metadata: {
+                total: results.length,
+                resultCount: results.length,
+                scope: intentObj.scope
+            }
+        }, intentObj.compatibility);
+    }
+    async executeConfigAwareTextFallback(intentObj, topK, scanError, orchestratorError) {
+        try {
+            const results = await this.runConfigAwareTextFallback(intentObj, topK);
+            const diagnostics = this.createPartialFailureDiagnostics(scanError, orchestratorError);
+            return {
+                schemaVersion: 'v1.0.0',
+                intent: 'find',
+                tool: 'codemap-find-fallback',
+                confidence: this.buildConfidence(results.length > 0 ? 0.65 : 0),
+                results,
+                diagnostics,
+                metadata: {
+                    total: results.length,
+                    resultCount: results.length,
+                    scope: intentObj.scope
+                }
+            };
+        }
+        catch (fallbackError) {
+            if (this.isMachineOutputMode()) {
+                process.exitCode = 1;
+            }
+            return {
+                schemaVersion: 'v1.0.0',
+                intent: 'find',
+                tool: 'codemap-find-fallback',
+                confidence: this.buildConfidence(0),
+                results: [],
+                diagnostics: this.createFailureDiagnostics(scanError, fallbackError, orchestratorError),
+                metadata: {
+                    total: 0,
+                    resultCount: 0,
+                    scope: intentObj.scope
+                }
+            };
+        }
+    }
+    async runConfigAwareTextFallback(intentObj, topK) {
+        const { config } = await loadCodemapConfig(process.cwd());
+        const discoveredFiles = await discoverProjectFiles({
+            rootDir: process.cwd(),
+            include: config.include,
+            exclude: config.exclude,
+            absolute: true,
+            gitignore: true
+        });
+        const { files, searchTerms, explicitPathMode } = this.resolveFallbackSearchScope(discoveredFiles, intentObj);
+        const results = [];
+        for (const file of files) {
+            const fileResults = await this.searchFileWithFallback(file, searchTerms, topK - results.length);
+            results.push(...fileResults);
+            if (results.length >= topK) {
+                return results.slice(0, topK);
+            }
+        }
+        if (explicitPathMode && intentObj.keywords.length === 0 && results.length === 0) {
+            const anchoredResults = await this.createExplicitPathFallbackResults(files, searchTerms, topK);
+            results.push(...anchoredResults);
+        }
+        return results.slice(0, topK);
+    }
+    resolveFallbackSearchScope(discoveredFiles, intentObj) {
+        const explicitPathTargets = intentObj.targets.filter(target => this.isPathLikeTarget(target));
+        const matchedTargetFiles = this.matchDiscoveredTargetFiles(discoveredFiles, explicitPathTargets);
+        if (matchedTargetFiles.length > 0) {
+            const pathTerms = explicitPathTargets.flatMap(target => {
+                const basename = path.basename(target);
+                return [basename, this.stripModuleExtension(basename)];
+            });
+            return {
+                files: matchedTargetFiles,
+                searchTerms: this.uniqueNonEmptyStrings(intentObj.keywords.length > 0 ? intentObj.keywords : pathTerms),
+                explicitPathMode: true
+            };
+        }
+        return {
+            files: discoveredFiles,
+            searchTerms: this.uniqueNonEmptyStrings(intentObj.keywords.length > 0 ? intentObj.keywords : intentObj.targets),
+            explicitPathMode: false
+        };
+    }
+    async searchFileWithFallback(file, searchTerms, remainingSlots) {
+        if (remainingSlots <= 0 || searchTerms.length === 0) {
+            return [];
+        }
+        const content = await readFile(file, 'utf-8');
+        const lines = content.split(/\r?\n/);
+        const results = [];
+        for (const [index, line] of lines.entries()) {
+            const matchedTerms = searchTerms.filter(term => line.includes(term));
+            if (matchedTerms.length === 0) {
+                continue;
+            }
+            const relativeFile = this.toProjectRelativePath(file);
+            const lineNumber = index + 1;
+            results.push(this.createFallbackResult(relativeFile, lineNumber, line, matchedTerms));
+            if (results.length >= remainingSlots) {
+                break;
+            }
+        }
+        return results;
+    }
+    async createExplicitPathFallbackResults(files, searchTerms, topK) {
+        const results = [];
+        for (const file of files) {
+            const content = await readFile(file, 'utf-8');
+            const firstLine = content.split(/\r?\n/, 1)[0] ?? '';
+            const relativeFile = this.toProjectRelativePath(file);
+            results.push(this.createFallbackResult(relativeFile, 1, firstLine || `Matched file path ${relativeFile}`, searchTerms));
+            if (results.length >= topK) {
+                break;
+            }
+        }
+        return results;
+    }
+    createFallbackResult(relativeFile, lineNumber, content, keywords) {
+        return {
+            id: `codemap-fallback:${relativeFile}:${lineNumber}`,
+            source: 'codemap-fallback',
+            toolScore: 0.65,
+            type: 'code',
+            file: relativeFile,
+            line: lineNumber,
+            location: {
+                file: relativeFile,
+                line: lineNumber,
+                column: 1
+            },
+            content: content.substring(0, 200),
+            relevance: 0.65,
+            keywords,
+            metadata: {
+                stability: true,
+                riskLevel: 'low'
+            }
+        };
+    }
+    matchDiscoveredTargetFiles(discoveredFiles, targets) {
+        const normalizedTargets = new Set(targets.flatMap(target => {
+            const absoluteTarget = path.resolve(process.cwd(), target);
+            return [
+                this.toPosixPath(absoluteTarget),
+                this.toPosixPath(path.relative(process.cwd(), absoluteTarget)),
+                this.toPosixPath(target)
+            ];
+        }));
+        return discoveredFiles.filter(file => {
+            const absoluteFile = path.resolve(file);
+            const relativeFile = path.relative(process.cwd(), absoluteFile);
+            return normalizedTargets.has(this.toPosixPath(absoluteFile))
+                || normalizedTargets.has(this.toPosixPath(relativeFile));
+        });
+    }
+    isPathLikeTarget(target) {
+        return target.includes('/') || target.includes('\\') || /\.[cm]?[jt]sx?$/i.test(target);
+    }
+    uniqueNonEmptyStrings(values) {
+        return Array.from(new Set(values.map(value => value.trim()).filter(Boolean)));
+    }
+    toProjectRelativePath(file) {
+        return this.toPosixPath(path.relative(process.cwd(), path.resolve(file)));
+    }
+    toPosixPath(filePath) {
+        return filePath.replace(/\\/g, '/');
+    }
+    withDiagnostics(output, diagnostics) {
+        return {
+            ...output,
+            diagnostics
+        };
+    }
+    createSuccessDiagnostics() {
+        return {
+            status: 'success',
+            items: []
+        };
+    }
+    createPartialFailureDiagnostics(scanError, orchestratorError) {
+        return {
+            status: 'partialFailure',
+            items: [
+                this.createDiagnostic('find-scanner-degraded', 'warning', `find 主扫描退化，已使用配置感知文本 fallback: ${this.errorMessage(scanError)}`, 'ast-grep', true, { orchestratorError: this.errorMessage(orchestratorError) })
+            ],
+            degradedTools: ['ast-grep']
+        };
+    }
+    createFailureDiagnostics(scanError, fallbackError, orchestratorError) {
+        return {
+            status: 'failure',
+            items: [
+                this.createDiagnostic('find-scanner-failed', 'error', `find 主扫描失败: ${this.errorMessage(scanError)}`, 'ast-grep', false, { orchestratorError: this.errorMessage(orchestratorError) }),
+                this.createDiagnostic('find-fallback-failed', 'error', `配置感知文本 fallback 失败: ${this.errorMessage(fallbackError)}`, 'codemap-find-fallback', false)
+            ],
+            failedTools: ['ast-grep', 'codemap-find-fallback']
+        };
+    }
+    createDiagnostic(code, severity, message, source, recoverable, details) {
+        return {
+            code,
+            severity,
+            message,
+            source,
+            recoverable,
+            ...(details ? { details } : {})
+        };
+    }
+    errorMessage(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    isMachineOutputMode() {
+        return this.args.json === true || this.args.structured === true || this.args.outputMode === 'machine';
+    }
+    /**
+     * 执行 read 聚合
+     */
+    async executeRead(intentObj, scope, topK) {
+        const [impactOutput, complexityOutput] = await Promise.all([
+            this.executeImpact(scope, topK),
+            this.executeComplexity(topK)
+        ]);
+        const mergedResults = this.mergeUnifiedResults(impactOutput.results, complexityOutput.results);
+        const results = mergedResults.slice(0, topK);
+        const analysis = {
+            intent: 'read',
+            impact: impactOutput.results
+                .filter(result => result.content.startsWith('被 '))
+                .map(result => ({
+                file: result.file,
+                location: result.location,
+                changedFiles: [result.file],
+                transitiveDependencies: result.metadata?.dependencies ?? [],
+                impactCount: result.metadata?.impactCount ?? 0,
+                risk: result.metadata?.riskLevel ?? 'low'
+            })),
+            complexity: complexityOutput.results
+                .filter(result => Boolean(result.metadata?.complexityMetrics))
+                .map(result => ({
+                file: result.file,
+                location: result.location,
+                metrics: result.metadata?.complexityMetrics ?? {
+                    cyclomatic: 0,
+                    cognitive: 0,
+                    maintainability: 0
+                },
+                risk: result.metadata?.riskLevel ?? 'low'
+            }))
+        };
+        return this.withCompatibility({
+            schemaVersion: 'v1.0.0',
+            intent: 'read',
+            tool: 'codemap-read',
+            confidence: this.combineConfidence([impactOutput.confidence, complexityOutput.confidence], results),
+            results,
+            analysis,
+            metadata: {
+                total: mergedResults.length,
+                resultCount: results.length,
+                scope
+            }
+        }, intentObj.compatibility);
+    }
+    /**
+     * 执行 link 聚合
+     */
+    async executeLink(intentObj, topK) {
+        const dependencyOutput = intentObj.targets.length > 0
+            ? await this.executeDeps(Math.max(topK, intentObj.targets.length))
+            : this.createEmptyOutput('link', 'codemap-link', intentObj.scope);
+        const codeMap = await this.loadCodeMap();
+        const dependency = codeMap
+            ? this.buildLinkDependencyAnalysis(codeMap, intentObj.targets)
+            : [];
+        const reference = codeMap
+            ? this.buildLinkReferenceAnalysis(codeMap, intentObj.targets, intentObj.keywords)
+            : [];
+        const referenceResults = this.buildReferenceResults(reference);
+        const mergedResults = this.mergeUnifiedResults(dependencyOutput.results, referenceResults);
+        const results = mergedResults.slice(0, topK);
+        const confidence = this.combineConfidence([
+            dependencyOutput.confidence,
+            this.buildConfidence(this.calculateConfidence(referenceResults))
+        ], results);
+        const analysis = {
+            intent: 'link',
+            ...(reference.length > 0 ? { reference } : {}),
+            ...(dependency.length > 0 ? { dependency } : {})
+        };
+        return this.withCompatibility({
+            schemaVersion: 'v1.0.0',
+            intent: 'link',
+            tool: 'codemap-link',
+            confidence,
+            results,
+            analysis,
+            metadata: {
+                total: mergedResults.length,
+                resultCount: results.length,
+                scope: intentObj.scope
+            }
+        }, intentObj.compatibility);
+    }
+    /**
+     * 执行 show 聚合
+     */
+    async executeShow(intentObj, topK) {
+        const codeMap = await this.loadCodeMap();
+        const modules = codeMap ? this.findMatchingModules(codeMap, intentObj.targets) : [];
+        const analysis = {
+            intent: 'show',
+            overview: modules.map(module => ({
+                title: path.basename(module.absolutePath),
+                file: this.toRelativePath(codeMap, module.absolutePath),
+                overview: module.overview ?? `模块 ${this.toRelativePath(codeMap, module.absolutePath)}，导出 ${module.exports.length} 个符号，依赖 ${module.dependencies.length} 个模块`,
+                exports: module.exports.map(exp => exp.name)
+            })),
+            documentation: modules.map(module => ({
+                title: path.basename(module.absolutePath),
+                file: this.toRelativePath(codeMap, module.absolutePath),
+                content: module.overview
+                    ?? `类型: ${module.type}; 代码行: ${module.stats.codeLines}; 导出: ${module.exports.map(exp => exp.name).join(', ') || '无'}`
+            }))
+        };
+        const results = this.buildShowResults(analysis).slice(0, topK);
+        return this.withCompatibility({
+            schemaVersion: 'v1.0.0',
+            intent: 'show',
+            tool: 'codemap-show',
+            confidence: this.buildConfidence(this.calculateConfidence(results)),
+            results,
+            analysis,
+            metadata: {
+                total: results.length,
+                resultCount: results.length,
+                scope: intentObj.scope
+            }
+        }, intentObj.compatibility);
+    }
+    /**
+     * 创建空输出
+     */
+    createEmptyOutput(intent, tool, scope) {
+        return {
+            schemaVersion: 'v1.0.0',
+            intent,
+            tool,
+            confidence: this.buildConfidence(0),
+            results: [],
+            metadata: {
+                total: 0,
+                resultCount: 0,
+                scope
+            }
+        };
+    }
+    /**
+     * 聚合多个 Confidence
+     */
+    combineConfidence(confidences, results) {
+        const effective = confidences.filter(confidence => Number.isFinite(confidence.score));
+        if (effective.length === 0) {
+            return this.buildConfidence(this.calculateConfidence(results));
+        }
+        const score = Math.round((effective.reduce((sum, confidence) => sum + confidence.score, 0) / effective.length) * 100) / 100;
+        return this.buildConfidence(score);
+    }
+    /**
+     * 构建 Confidence
+     */
+    buildConfidence(score) {
+        const normalizedScore = Math.round(Math.max(0, Math.min(score, 1)) * 100) / 100;
+        return {
+            score: normalizedScore,
+            level: calculateConfidenceLevel(normalizedScore)
+        };
+    }
+    /**
+     * 合并 UnifiedResult
+     */
+    mergeUnifiedResults(...collections) {
+        const merged = new Map();
+        for (const results of collections) {
+            for (const result of results) {
+                const key = `${result.file}:${result.location?.line ?? result.line ?? 1}`;
+                const existing = merged.get(key);
+                if (!existing || result.relevance > existing.relevance) {
+                    merged.set(key, result);
+                }
+            }
+        }
+        return Array.from(merged.values()).sort((left, right) => right.relevance - left.relevance);
+    }
+    /**
+     * 加载 CodeMap 数据
+     */
+    async loadCodeMap() {
+        try {
+            const dataPath = resolveDataPath();
+            const raw = await readFile(dataPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 查找目标模块
+     */
+    findMatchingModules(codeMap, targets) {
+        const seen = new Set();
+        const modules = [];
+        for (const target of targets) {
+            const module = this.findMatchingModule(codeMap, target);
+            if (module && !seen.has(module.id)) {
+                seen.add(module.id);
+                modules.push(module);
+            }
+        }
+        return modules;
+    }
+    /**
+     * 查找单个匹配模块
+     */
+    findMatchingModule(codeMap, target) {
+        return codeMap.modules.find(module => {
+            const relativePath = this.toRelativePath(codeMap, module.absolutePath);
+            return module.absolutePath.includes(target) || relativePath.includes(target);
+        });
+    }
+    /**
+     * 构建 link dependency analysis
+     */
+    buildLinkDependencyAnalysis(codeMap, targets) {
+        return this.findMatchingModules(codeMap, targets).map(module => ({
+            file: this.toRelativePath(codeMap, module.absolutePath),
+            location: {
+                file: this.toRelativePath(codeMap, module.absolutePath),
+                line: 1,
+                column: 1
+            },
+            imports: module.dependencies,
+            importedBy: module.dependents.map(id => {
+                const dependent = codeMap.modules.find(candidate => candidate.id === id);
+                return dependent ? this.toRelativePath(codeMap, dependent.absolutePath) : id;
+            }),
+            cycles: []
+        }));
+    }
+    /**
+     * 构建 link reference analysis
+     */
+    buildLinkReferenceAnalysis(codeMap, targets, keywords) {
+        const items = [];
+        for (const module of this.findMatchingModules(codeMap, targets)) {
+            items.push(this.buildModuleReferenceItem(codeMap, module));
+        }
+        for (const keyword of keywords) {
+            items.push(this.buildKeywordReferenceItem(codeMap, keyword));
+        }
+        const merged = new Map();
+        for (const item of items) {
+            const existing = merged.get(item.target);
+            if (!existing) {
+                merged.set(item.target, item);
+                continue;
+            }
+            merged.set(item.target, {
+                target: item.target,
+                callers: Array.from(new Set([...existing.callers, ...item.callers])),
+                callees: Array.from(new Set([...existing.callees, ...item.callees])),
+                matches: [...existing.matches, ...item.matches]
+            });
+        }
+        return Array.from(merged.values());
+    }
+    /**
+     * 基于模块构建 reference item
+     */
+    buildModuleReferenceItem(codeMap, module) {
+        const relativePath = this.toRelativePath(codeMap, module.absolutePath);
+        const exportedSymbols = new Set(module.exports.map(exp => exp.name));
+        const matchTokens = new Set([
+            relativePath,
+            this.stripModuleExtension(relativePath),
+            path.basename(relativePath),
+            this.stripModuleExtension(path.basename(relativePath)),
+            module.id
+        ]);
+        const callers = new Set();
+        const matches = [];
+        for (const candidate of codeMap.modules) {
+            if (candidate.id === module.id) {
+                continue;
+            }
+            const candidatePath = this.toRelativePath(codeMap, candidate.absolutePath);
+            for (const entry of candidate.imports) {
+                const sourceMatched = this.matchesModuleSource(entry.source, matchTokens);
+                const symbolMatched = entry.specifiers.some(specifier => exportedSymbols.has(specifier.name));
+                if (!sourceMatched && !symbolMatched) {
+                    continue;
+                }
+                callers.add(candidatePath);
+                matches.push({
+                    file: candidatePath,
+                    line: 1,
+                    snippet: entry.source
+                });
+            }
+        }
+        return {
+            target: relativePath,
+            callers: Array.from(callers),
+            callees: module.dependencies,
+            matches
+        };
+    }
+    /**
+     * 基于关键词构建 reference item
+     */
+    buildKeywordReferenceItem(codeMap, keyword) {
+        const callers = new Set();
+        const callees = new Set();
+        const matches = [];
+        for (const module of codeMap.modules) {
+            const relativePath = this.toRelativePath(codeMap, module.absolutePath);
+            const definesKeyword = module.exports.some(exp => exp.name === keyword)
+                || module.symbols.some(symbol => symbol.name === keyword);
+            if (definesKeyword) {
+                callees.add(relativePath);
+            }
+            for (const entry of module.imports) {
+                const sourceMatched = entry.source.toLowerCase().includes(keyword.toLowerCase());
+                const specifierMatched = entry.specifiers.some(specifier => specifier.name === keyword || specifier.alias === keyword);
+                if (!sourceMatched && !specifierMatched) {
+                    continue;
+                }
+                callers.add(relativePath);
+                matches.push({
+                    file: relativePath,
+                    line: 1,
+                    snippet: entry.source
+                });
+            }
+        }
+        return {
+            target: keyword,
+            callers: Array.from(callers),
+            callees: Array.from(callees),
+            matches
+        };
+    }
+    /**
+     * 将 reference analysis 转为 results
+     */
+    buildReferenceResults(items) {
+        return items.map(item => ({
+            id: `reference-${item.target}`,
+            source: 'codemap',
+            toolScore: 0.8,
+            type: 'symbol',
+            file: item.matches[0]?.file ?? item.callees[0] ?? item.target,
+            line: item.matches[0]?.line ?? 1,
+            location: {
+                file: item.matches[0]?.file ?? item.callees[0] ?? item.target,
+                line: item.matches[0]?.line ?? 1,
+                column: 1
+            },
+            content: `发现 ${item.callers.length} 个引用方，${item.callees.length} 个关联目标`,
+            relevance: Math.min(0.4 + item.callers.length * 0.1, 0.95),
+            keywords: [item.target],
+            metadata: {
+                dependencies: item.callees,
+                impactCount: item.callers.length,
+                stability: true,
+                riskLevel: item.callers.length > 10 ? 'high' : item.callers.length > 3 ? 'medium' : 'low'
+            }
+        }));
+    }
+    /**
+     * 构建 show 结果
+     */
+    buildShowResults(analysis) {
+        const results = [];
+        for (const section of analysis.overview ?? []) {
+            results.push({
+                id: `show-overview-${section.file}`,
+                source: 'codemap',
+                toolScore: 0.75,
+                type: 'documentation',
+                file: section.file,
+                line: 1,
+                location: {
+                    file: section.file,
+                    line: 1,
+                    column: 1
+                },
+                content: section.overview,
+                relevance: 0.75,
+                keywords: section.exports,
+                metadata: {
+                    stability: true,
+                    riskLevel: 'low'
+                }
+            });
+        }
+        for (const section of analysis.documentation ?? []) {
+            results.push({
+                id: `show-documentation-${section.file}`,
+                source: 'codemap',
+                toolScore: 0.7,
+                type: 'documentation',
+                file: section.file,
+                line: 1,
+                location: {
+                    file: section.file,
+                    line: 1,
+                    column: 1
+                },
+                content: section.content,
+                relevance: 0.7,
+                keywords: [],
+                metadata: {
+                    stability: true,
+                    riskLevel: 'low'
+                }
+            });
+        }
+        return this.mergeUnifiedResults(results);
+    }
+    /**
+     * 转为相对路径
+     */
+    toRelativePath(codeMap, filePath) {
+        return path.relative(codeMap.project.rootDir, filePath).replace(/\\/g, '/');
+    }
+    /**
+     * 去除模块扩展名
+     */
+    stripModuleExtension(value) {
+        return value.replace(/\.[cm]?[jt]sx?$/i, '');
+    }
+    /**
+     * 判断 import source 是否引用目标模块
+     */
+    matchesModuleSource(source, tokens) {
+        const normalizedSource = this.stripModuleExtension(source).replace(/\\/g, '/').toLowerCase();
+        for (const token of tokens) {
+            const normalizedToken = this.stripModuleExtension(token).replace(/\\/g, '/').toLowerCase();
+            if (!normalizedToken) {
+                continue;
+            }
+            if (normalizedSource === normalizedToken
+                || normalizedSource.endsWith(normalizedToken)
+                || normalizedSource.includes(normalizedToken)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * 为 UnifiedResult 添加 location 字段
+     */
+    enrichWithLocation(results) {
+        return results.map(result => {
+            // 如果已经有 line 字段，构建完整的 location
+            if (result.line && result.line > 0) {
+                const location = {
+                    file: result.file,
+                    line: result.line,
+                    column: 1, // 默认列号
+                };
+                return { ...result, location };
+            }
+            // 否则只添加 file
+            const location = {
+                file: result.file,
+                line: 1,
+                column: 1,
+            };
+            return { ...result, location };
+        });
+    }
+    /**
+     * 执行影响分析
+     */
+    async executeImpact(scope, topK) {
+        const command = new ImpactCommand();
+        const args = {
+            targets: this.args.targets || [],
+            scope: scope,
+        };
+        const results = await command.runEnhanced(args);
+        // 关联测试文件
+        const resultsWithTests = await this.attachTestFiles(results);
+        // 计算置信度
+        const confidenceScore = this.calculateConfidence(resultsWithTests);
+        const confidence = {
+            score: confidenceScore,
+            level: confidenceScore >= 0.7 ? 'high' : confidenceScore >= 0.4 ? 'medium' : 'low',
+        };
+        // 添加 location 字段
+        const resultsWithLocation = this.enrichWithLocation(resultsWithTests);
+        const typedResults = resultsWithLocation;
+        return {
+            schemaVersion: 'v1.0.0',
+            intent: 'read',
+            tool: 'codemap-impact',
+            confidence,
+            results: typedResults.slice(0, topK),
+            metadata: {
+                total: resultsWithTests.length,
+                scope,
+                resultCount: typedResults.slice(0, topK).length,
+            },
+        };
+    }
+    /**
+     * 计算置信度分数
+     */
+    calculateConfidence(results) {
+        if (!results || results.length === 0) {
+            return 0;
+        }
+        // 基于结果数量和质量计算置信度
+        const resultCount = results.length;
+        // 假设至少有结果的情况下，基础置信度为 0.5
+        // 结果越多置信度越高
+        const score = Math.min(0.5 + (resultCount / 10), 1);
+        return Math.round(score * 100) / 100;
+    }
+    /**
+     * 执行依赖分析
+     */
+    async executeDeps(topK) {
+        const command = new DepsCommand();
+        const args = {
+            targets: this.args.targets || [],
+        };
+        const results = await command.runEnhanced(args);
+        // 关联测试文件
+        const resultsWithTests = await this.attachTestFiles(results);
+        // 计算置信度
+        const confidenceScore = this.calculateConfidence(resultsWithTests);
+        const confidence = {
+            score: confidenceScore,
+            level: confidenceScore >= 0.7 ? 'high' : confidenceScore >= 0.4 ? 'medium' : 'low',
+        };
+        // 添加 location 字段
+        const resultsWithLocation = this.enrichWithLocation(resultsWithTests);
+        const typedResults = resultsWithLocation;
+        return {
+            schemaVersion: 'v1.0.0',
+            intent: 'link',
+            tool: 'codemap-deps',
+            confidence,
+            results: typedResults.slice(0, topK),
+            metadata: {
+                total: resultsWithTests.length,
+                resultCount: typedResults.slice(0, topK).length,
+            },
+        };
+    }
+    /**
+     * 执行复杂度分析
+     */
+    async executeComplexity(topK) {
+        const command = new ComplexityCommand();
+        const args = {
+            targets: this.args.targets || [],
+        };
+        const results = await command.runEnhanced(args);
+        // 关联测试文件
+        const resultsWithTests = await this.attachTestFiles(results);
+        // 计算置信度
+        const confidenceScore = this.calculateConfidence(resultsWithTests);
+        const confidence = {
+            score: confidenceScore,
+            level: confidenceScore >= 0.7 ? 'high' : confidenceScore >= 0.4 ? 'medium' : 'low',
+        };
+        // 添加 location 字段
+        const resultsWithLocation = this.enrichWithLocation(resultsWithTests);
+        const typedResults = resultsWithLocation;
+        return {
+            schemaVersion: 'v1.0.0',
+            intent: 'read',
+            tool: 'codemap-complexity',
+            confidence,
+            results: typedResults.slice(0, topK),
+            metadata: {
+                total: resultsWithTests.length,
+                resultCount: typedResults.slice(0, topK).length,
+            },
+        };
+    }
+    /**
+     * 关联测试文件
+     */
+    async attachTestFiles(results) {
+        if (!this.args.includeTests) {
+            return results;
+        }
+        // 为每个结果附加测试文件信息
+        for (const result of results) {
+            if (result.file) {
+                const testFile = await resolveTestFile(result.file);
+                if (testFile) {
+                    result.metadata = result.metadata || {};
+                    result.metadata.testFile = testFile;
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * 打印人类可读输出
+     */
+    printHumanOutput(results, intent) {
+        console.log(chalk.bold(`\n📊 ${intent.toUpperCase()} 分析结果\n`));
+        const resultsArray = results;
+        for (const result of resultsArray) {
+            const lineInfo = result.location?.line ? `:${result.location.line}` : '';
+            console.log(chalk.cyan(`📁 ${result.file}${lineInfo}`));
+            console.log(`   ${result.content}`);
+            console.log(chalk.gray(`   相关度: ${(result.relevance * 100).toFixed(1)}%`));
+            if (result.metadata?.testFile) {
+                console.log(chalk.green(`   🧪 测试: ${result.metadata.testFile}`));
+            }
+            console.log();
+        }
+    }
+}
+function normalizeStringArray(value) {
+    if (typeof value === 'string') {
+        return [value];
+    }
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === 'string');
+    }
+    return [];
+}
+export function parseAnalyzeArgs(argv) {
+    try {
+        const { values, positionals } = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: ANALYZE_PARSE_OPTIONS,
+        });
+        const positionalTargets = positionals?.filter(position => !position.startsWith('-')) || [];
+        const explicitTargets = normalizeStringArray(values.targets);
+        const allTargets = [...explicitTargets, ...positionalTargets];
+        const keywords = normalizeStringArray(values.keywords);
+        return {
+            intent: values.intent,
+            targets: allTargets.length > 0 ? allTargets : undefined,
+            keywords: keywords.length > 0 ? keywords : undefined,
+            scope: values.scope,
+            topK: values.topK ? Number.parseInt(values.topK, 10) : undefined,
+            includeTests: values['include-tests'],
+            includeGitHistory: values['include-git-history'],
+            json: values.json,
+            human: values.human,
+            structured: values.structured,
+            outputMode: values['output-mode'],
+        };
+    }
+    catch {
+        return {};
+    }
+}
+export async function executeAnalyzeTool(args) {
+    const startedAt = performance.now();
+    try {
+        const command = new AnalyzeCommand(args);
+        const output = await command.execute();
+        let result = output;
+        if (args.structured) {
+            const structuredOutput = JSON.parse(JSON.stringify(output));
+            if (structuredOutput.results) {
+                structuredOutput.results = structuredOutput.results.map(entry => {
+                    const { content, ...rest } = entry;
+                    void content;
+                    return rest;
+                });
+            }
+            result = structuredOutput;
+        }
+        return createContractSuccess({
+            tool: 'analyze',
+            rootDir: process.cwd(),
+            durationMs: performance.now() - startedAt,
+        }, result);
+    }
+    catch (error) {
+        return createContractError({
+            tool: 'analyze',
+            rootDir: process.cwd(),
+            durationMs: performance.now() - startedAt,
+        }, normalizeExecutionError(error));
+    }
+}
+/**
+ * Human-readable renderer for analyze output (chalk + padEnd table pattern)
+ */
+export function formatAnalyzeHuman(output) {
+    const lines = [];
+    // Warnings
+    for (const warning of output.warnings || []) {
+        lines.push(chalk.yellow(`Warning: ${warning.message}`));
+    }
+    // Header
+    const intentLabel = output.intent?.toUpperCase() || 'ANALYSIS';
+    lines.push(chalk.bold(`\n${intentLabel} Analysis Results\n`));
+    // Table header
+    const TYPE_WIDTH = 12;
+    const NAME_WIDTH = 30;
+    const PATH_WIDTH = 40;
+    const header = 'TYPE'.padEnd(TYPE_WIDTH) +
+        'NAME'.padEnd(NAME_WIDTH) +
+        'PATH'.padEnd(PATH_WIDTH) +
+        'RELEVANCE';
+    lines.push(header);
+    lines.push('-'.repeat(header.length));
+    // Data rows
+    for (const result of output.results || []) {
+        const type = (result.type || '').padEnd(TYPE_WIDTH);
+        const name = (result.id || '').substring(0, NAME_WIDTH - 1).padEnd(NAME_WIDTH);
+        const lineInfo = result.location?.line ? `:${result.location.line}` : '';
+        const filePath = `${result.file}${lineInfo}`.substring(0, PATH_WIDTH - 1).padEnd(PATH_WIDTH);
+        const relevance = `${(result.relevance * 100).toFixed(1)}%`;
+        lines.push(`${type}${name}${filePath}${relevance}`);
+    }
+    // Summary
+    if (output.results.length > 0) {
+        lines.push('');
+    }
+    lines.push(chalk.gray(`Tools: ${output.tool}, Confidence: ${output.confidence.level} (${output.confidence.score})`));
+    return lines.join('\n');
+}
+//# sourceMappingURL=analyze.js.map