@mycodemap/mycodemap 0.1.0

package/dist/orchestrator/git-analyzer.d.ts

@@ -0,0 +1,192 @@
+import { HeatScore } from './types';
+/**
+ * 风险等级类型
+ */
+export type RiskLevel = 'high' | 'medium' | 'low';
+/**
+ * 提交标签类型
+ */
+export type CommitTagType = 'BUGFIX' | 'FEATURE' | 'REFACTOR' | 'CONFIG' | 'DOCS' | 'DELETE' | 'UNKNOWN';
+/**
+ * 提交信息接口
+ */
+export interface CommitInfo {
+    /** 提交哈希 */
+    hash: string;
+    /** 提交信息 */
+    message: string;
+    /** 提交日期 */
+    date: Date;
+    /** 提交作者 */
+    author: string;
+    /** 修改的文件列表 */
+    files: string[];
+    /** 解析的 TAG */
+    tag?: CommitTag;
+}
+/**
+ * 提交标签接口
+ */
+export interface CommitTag {
+    /** 标签类型 */
+    type: CommitTagType;
+    /** 模块/作用域 */
+    scope: string;
+    /** 提交描述 */
+    subject: string;
+}
+/**
+ * 风险评分结果接口
+ */
+export interface RiskScore {
+    /** 风险等级 */
+    level: RiskLevel;
+    /** 综合分数 (0-1) */
+    score: number;
+    /** 依赖复杂度评分 */
+    gravity: number;
+    /** 热度评分 */
+    heat: HeatScore;
+    /** 影响面评分 */
+    impact: number;
+    /** 风险因素说明 */
+    riskFactors: string[];
+}
+/**
+ * AI 饲料接口
+ */
+export interface AIFeed {
+    /** 文件路径 */
+    file: string;
+    /** 依赖复杂度 (出度+入度) */
+    gravity: number;
+    /** 热度评分 */
+    heat: HeatScore;
+    /** 元数据 */
+    meta: {
+        since?: string;
+        owner?: string;
+        stable?: boolean;
+        why?: string;
+    };
+    /** 依赖的文件 */
+    deps: string[];
+    /** 被哪些文件依赖 */
+    dependents: string[];
+}
+/**
+ * 标签风险权重映射
+ * 基于 REFACTOR_REQUIREMENTS.md 第 8.6 节
+ */
+export declare const TAG_WEIGHTS: Record<string, number>;
+/**
+ * 提交标签正则表达式
+ * 匹配格式: [TAG] scope: message
+ */
+export declare const COMMIT_TAG_REGEX: RegExp;
+/**
+ * GitAnalyzer 类
+ * 提供 Git 历史分析和风险评分功能
+ */
+export declare class GitAnalyzer {
+    /**
+     * 检查指定路径是否为 Git 仓库
+     */
+    isGitRepository(projectRoot: string): Promise<boolean>;
+    /**
+     * 分析单个文件的 Git 热度
+     * @param filePath - 文件路径（相对于 projectRoot）
+     * @param projectRoot - 项目根目录
+     * @returns HeatScore 热度评分
+     */
+    analyzeFileHeat(filePath: string, projectRoot: string): Promise<HeatScore>;
+    /**
+     * 分析目录下所有文件的 Git 热度
+     * @param dirPath - 目录路径（相对于 projectRoot）
+     * @param projectRoot - 项目根目录
+     * @returns Map<文件路径, HeatScore>
+     */
+    analyzeDirectoryHeat(dirPath: string, projectRoot: string): Promise<Map<string, HeatScore>>;
+    /**
+     * 计算风险评分（简单版本 - 任务要求）
+     * 基于 REFACTOR_REQUIREMENTS.md 第 8.6 节的公式
+     *
+     * @param gravity - 依赖复杂度（出度+入度）
+     * @param heat - 热度评分
+     * @param impact - 影响面（被依赖文件数）
+     * @param stable - 是否稳定
+     * @returns RiskLevel 风险等级
+     */
+    calculateRiskLevel(gravity: number, heat: HeatScore, impact: number, stable: boolean): RiskLevel;
+    /**
+     * 计算风险评分（完整版本 - 设计文档版本）
+     * @param targetFiles - 目标文件列表
+     * @param commits - 提交信息列表
+     * @param feedData - AI 饲料数据
+     * @returns RiskScore 风险评分结果
+     */
+    calculateRiskScore(targetFiles: string[], commits: CommitInfo[], feedData: AIFeed[]): RiskScore;
+    /**
+     * 查找相关提交
+     * 支持关键词搜索和文件搜索两种模式
+     *
+     * @param keywords - 关键词列表
+     * @param files - 文件路径列表
+     * @param options - 选项（最大提交数、项目根目录）
+     * @returns CommitInfo[] 提交信息列表
+     */
+    findRelatedCommits(keywords: string[], files: string[], options: {
+        maxCommits: number;
+        projectRoot: string;
+    }): Promise<CommitInfo[]>;
+    /**
+     * 解析提交信息中的 TAG
+     * @param message - 提交信息
+     * @returns CommitTag | undefined
+     */
+    parseCommitTag(message: string): CommitTag | undefined;
+    /**
+     * 验证提交信息格式
+     * @param message - 提交信息
+     * @returns 是否有效
+     */
+    validateCommitMessage(message: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * 创建空热度评分
+     */
+    private createEmptyHeatScore;
+    /**
+     * 格式化日期为 ISO 日期字符串
+     */
+    private formatDate;
+    /**
+     * 获取文件的提交历史
+     */
+    private getFileCommits;
+    /**
+     * 获取目录下最近有修改的文件列表
+     */
+    private getModifiedFilesInDirectory;
+    /**
+     * 基于关键词搜索提交
+     */
+    private searchByKeywords;
+    /**
+     * 基于文件搜索提交
+     */
+    private searchByFiles;
+    /**
+     * 解析 Git 日志（无文件列表）
+     */
+    private parseGitLog;
+    /**
+     * 解析 Git 日志（含文件列表）
+     * 格式: hash|message|date|author\n\nfile1\nfile2\n\nhash|...
+     */
+    private parseGitLogWithFiles;
+}
+export type { HeatScore };
+//# sourceMappingURL=git-analyzer.d.ts.map

package/dist/orchestrator/git-analyzer.d.ts.map

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