@mycodemap/mycodemap 0.1.0

package/dist/orchestrator/commit-validator.js

@@ -0,0 +1,87 @@
+/**
+ * [META] Commit 格式验证器
+ * [WHY] 统一执行 CI 门禁的提交信息规则，避免本地与服务端口径漂移
+ */
+export const VALID_TAGS = [
+    'BUGFIX',
+    'FEATURE',
+    'REFACTOR',
+    'CONFIG',
+    'DOCS',
+    'DELETE',
+];
+/**
+ * 验证 Commit 消息是否符合 [TAG] 格式
+ * @param commitMessage - Commit 消息内容
+ * @returns 验证结果
+ */
+export function validateCommitMessage(commitMessage) {
+    const firstLine = commitMessage.split('\n')[0]?.trim() ?? '';
+    if (!firstLine) {
+        return {
+            valid: false,
+            errorCode: 'E0007',
+            errorMessage: 'Commit message cannot be empty',
+        };
+    }
+    // 严格格式: [TAG] scope: message
+    const tagPattern = new RegExp(`^\\[(${VALID_TAGS.join('|')})\\]\\s+([^:]+):\\s+(.+)$`);
+    const match = firstLine.match(tagPattern);
+    if (!match) {
+        return {
+            valid: false,
+            errorCode: 'E0007',
+            errorMessage: `Expected format: [TAG] scope: message. Valid tags: ${VALID_TAGS.join(', ')}`,
+        };
+    }
+    const tag = match[1];
+    const scope = match[2]?.trim() ?? '';
+    const message = match[3]?.trim() ?? '';
+    if (!scope || !message) {
+        return {
+            valid: false,
+            errorCode: 'E0007',
+            errorMessage: 'Scope and message are required. Expected: [TAG] scope: message',
+        };
+    }
+    return {
+        valid: true,
+        tag,
+        commitMessage: `${scope}: ${message}`,
+    };
+}
+/**
+ * 从 git log 获取最近的 Commit 消息并验证
+ * @param count - 获取的 Commit 数量
+ * @returns 验证结果数组
+ */
+export async function validateRecentCommits(count = 10, range) {
+    const { execSync } = await import('child_process');
+    try {
+        const command = range
+            ? `git log --format=%s ${range}`
+            : `git log -${count} --pretty=format:"%s"`;
+        const output = execSync(command, {
+            encoding: 'utf-8',
+        });
+        const messages = output.split('\n').filter(Boolean);
+        return messages.map(validateCommitMessage);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 验证并输出结果到控制台
+ */
+export function validateAndPrint(message) {
+    const result = validateCommitMessage(message);
+    if (result.valid) {
+        console.log(`Valid commit: [${result.tag}] ${result.commitMessage}`);
+    }
+    else {
+        console.error(`ERROR: ${result.errorCode}: ${result.errorMessage}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=commit-validator.js.map

package/dist/orchestrator/commit-validator.js.map

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

package/dist/orchestrator/confidence.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 置信度计算机制
+ * 用于评估搜索结果的质量，决定是否触发回退策略
+ */
+import { UnifiedResult } from './types';
+type IntentType = 'impact' | 'dependency' | 'search' | 'documentation' | 'complexity' | 'overview' | 'refactor' | 'reference';
+interface SearchResult extends UnifiedResult {
+}
+interface ConfidenceResult {
+    score: number;
+    level: 'high' | 'medium' | 'low';
+    reasons: string[];
+}
+declare const CONFIDENCE_THRESHOLDS: Record<IntentType, {
+    high: number;
+    medium: number;
+}>;
+declare function clamp(value: number, min: number, max: number): number;
+declare function getRelevance(result: SearchResult): number;
+declare function getMatchCount(result: SearchResult): number;
+declare function getThreshold(intent: IntentType, level: 'high' | 'medium'): number;
+export declare function calculateConfidence(results: SearchResult[], intent: IntentType): ConfidenceResult;
+export type { IntentType, SearchResult, ConfidenceResult };
+export { CONFIDENCE_THRESHOLDS, getThreshold, getRelevance, getMatchCount, clamp };
+//# sourceMappingURL=confidence.d.ts.map

package/dist/orchestrator/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/orchestrator/confidence.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,KAAK,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,eAAe,GACpD,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAGvE,UAAU,YAAa,SAAQ,aAAa;CAAG;AAG/C,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAGD,QAAA,MAAM,qBAAqB,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAS/E,CAAC;AAGF,iBAAS,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAGD,iBAAS,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAclD;AAGD,iBAAS,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAMnD;AAGD,iBAAS,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAE1E;AAGD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,UAAU,GACjB,gBAAgB,CA8FlB;AAGD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC"}

package/dist/orchestrator/confidence.js

@@ -0,0 +1,138 @@
+// [META] since:2026-03 | owner:orchestrator-team | stable:true
+// [WHY] Confidence calculation mechanism for evaluating search result quality
+// and determining fallback strategies based on result count, quality, and scenario matching
+// 每种 intent 的阈值配置
+const CONFIDENCE_THRESHOLDS = {
+    impact: { high: 0.7, medium: 0.4 },
+    dependency: { high: 0.7, medium: 0.4 },
+    search: { high: 0.5, medium: 0.25 },
+    documentation: { high: 0.5, medium: 0.25 },
+    complexity: { high: 0.6, medium: 0.3 },
+    overview: { high: 0.6, medium: 0.3 },
+    refactor: { high: 0.6, medium: 0.3 },
+    reference: { high: 0.5, medium: 0.25 },
+};
+// 辅助函数：限制数值范围
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+// 辅助函数：获取结果相关度（兼容多种字段格式）
+function getRelevance(result) {
+    // 优先使用 relevance，其次 toolScore，最后 score
+    if ('relevance' in result && typeof result.relevance === 'number') {
+        return result.relevance;
+    }
+    if ('toolScore' in result && typeof result.toolScore === 'number') {
+        return result.toolScore;
+    }
+    // 兼容可能存在的 score 字段
+    const r = result;
+    if ('score' in r && typeof r.score === 'number') {
+        return r.score;
+    }
+    return 0;
+}
+// 辅助函数：获取结果匹配次数
+function getMatchCount(result) {
+    // 基于 keywords 数量或返回 1（至少匹配一次）
+    if (result.keywords && Array.isArray(result.keywords)) {
+        return result.keywords.length;
+    }
+    return 1;
+}
+// 辅助函数：获取指定 intent 和 level 的阈值
+function getThreshold(intent, level) {
+    return CONFIDENCE_THRESHOLDS[intent][level];
+}
+// 核心函数：计算置信度
+export function calculateConfidence(results, intent) {
+    const reasons = [];
+    // 1. 结果数量评分 (40%权重)
+    // 最高5个结果得满分，按比例递减
+    const countScore = Math.min(results.length / 5, 1);
+    const countWeight = 0.4;
+    if (results.length === 0) {
+        reasons.push('未找到任何结果');
+    }
+    else if (results.length <= 5) {
+        reasons.push(`找到 ${results.length} 个相关结果`);
+    }
+    else {
+        reasons.push(`找到 ${results.length} 个相关结果（超出最优数量）`);
+    }
+    // 2. 结果质量评分 (40%权重)
+    // 基于结果平均相关度
+    let qualityScore = 0;
+    if (results.length > 0) {
+        const totalRelevance = results.reduce((sum, r) => sum + getRelevance(r), 0);
+        qualityScore = totalRelevance / results.length;
+    }
+    const qualityWeight = 0.4;
+    if (results.length > 0) {
+        const avgRelevance = Math.round(qualityScore * 100);
+        reasons.push(`平均相关度 ${avgRelevance}%`);
+    }
+    // 3. 场景匹配评分 (20%权重)
+    // 基于 intent 类型的特定规则
+    let scenarioScore = 0.5; // 默认中等
+    switch (intent) {
+        case 'search':
+            // search 对数量敏感
+            scenarioScore = results.length >= 3 ? 0.8 : results.length > 0 ? 0.5 : 0.2;
+            break;
+        case 'impact':
+        case 'dependency':
+            // impact/dependency 对质量敏感
+            scenarioScore = qualityScore >= 0.7 ? 0.9 : qualityScore >= 0.4 ? 0.6 : 0.3;
+            break;
+        case 'documentation':
+            // documentation 宽松一些
+            scenarioScore = results.length > 0 ? 0.7 : 0.3;
+            break;
+        case 'overview':
+            // overview 需要更多结果
+            scenarioScore = results.length >= 5 ? 0.9 : results.length >= 3 ? 0.6 : 0.3;
+            break;
+        case 'complexity':
+            // complexity 依赖质量
+            scenarioScore = qualityScore >= 0.6 ? 0.85 : 0.4;
+            break;
+        case 'refactor':
+            // refactor 需要高质量结果
+            scenarioScore = qualityScore >= 0.7 && results.length >= 2 ? 0.8 : 0.4;
+            break;
+        case 'reference':
+            // reference 适中
+            scenarioScore = results.length >= 2 && qualityScore >= 0.5 ? 0.75 : 0.4;
+            break;
+        default:
+            scenarioScore = 0.5;
+    }
+    const scenarioWeight = 0.2;
+    reasons.push(`场景 '${intent}' 匹配度评估完成`);
+    // 计算综合分数
+    const rawScore = countScore * countWeight +
+        qualityScore * qualityWeight +
+        scenarioScore * scenarioWeight;
+    // 限制在 [0, 1] 范围
+    const score = clamp(rawScore, 0, 1);
+    // 确定置信度级别
+    const highThreshold = getThreshold(intent, 'high');
+    const mediumThreshold = getThreshold(intent, 'medium');
+    let level;
+    if (score >= highThreshold) {
+        level = 'high';
+        reasons.push(`置信度 ${Math.round(score * 100)}% 达到高级阈值 (${Math.round(highThreshold * 100)}%)`);
+    }
+    else if (score >= mediumThreshold) {
+        level = 'medium';
+        reasons.push(`置信度 ${Math.round(score * 100)}% 达到中级阈值 (${Math.round(mediumThreshold * 100)}%)`);
+    }
+    else {
+        level = 'low';
+        reasons.push(`置信度 ${Math.round(score * 100)}% 低于中级阈值 (${Math.round(mediumThreshold * 100)}%)，建议调整关键词`);
+    }
+    return { score, level, reasons };
+}
+export { CONFIDENCE_THRESHOLDS, getThreshold, getRelevance, getMatchCount, clamp };
+//# sourceMappingURL=confidence.js.map

package/dist/orchestrator/confidence.js.map

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

package/dist/orchestrator/file-header-scanner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * [META] 文件头注释扫描器
+ * [WHY] 为 pre-commit 与 CI 提供统一的 [META]/[WHY] 校验逻辑
+ */
+export declare const SUPPORTED_EXTENSIONS: string[];
+export interface FileHeaderResult {
+    filePath: string;
+    valid: boolean;
+    errorCode?: 'E0008' | 'E0009';
+    errorMessage?: string;
+    hasMeta: boolean;
+    hasWhy: boolean;
+}
+export interface ScanOptions {
+    directory: string;
+}
+/**
+ * 扫描文件头注释
+ * @param filePath - 文件路径
+ * @returns 扫描结果
+ */
+export declare function scanFileHeader(filePath: string): FileHeaderResult;
+/**
+ * 扫描目录下的所有支持的文件
+ * @param options - 扫描选项
+ * @returns 扫描结果数组
+ */
+export declare function scanDirectory(options: ScanOptions): FileHeaderResult[];
+/**
+ * 验证并输出结果到控制台
+ */
+export declare function scanAndPrint(directory: string): void;
+/**
+ * 评估危险置信度
+ * 基于代码变更的风险级别进行评估
+ */
+export interface RiskAssessment {
+    level: 'low' | 'medium' | 'high' | 'critical';
+    confidence: number;
+    factors: string[];
+}
+/**
+ * 评估代码变更的风险
+ * @param changedFiles - 变更的文件列表
+ * @returns 风险评估结果
+ */
+export declare function assessRisk(changedFiles: string[]): RiskAssessment;
+//# sourceMappingURL=file-header-scanner.d.ts.map

package/dist/orchestrator/file-header-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-header-scanner.d.ts","sourceRoot":"","sources":["../../src/orchestrator/file-header-scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,eAAO,MAAM,oBAAoB,UAAiD,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AASD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAqClB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,EAAE,CA+BtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAqBpD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,cAAc,CA0CjE"}

package/dist/orchestrator/file-header-scanner.js

@@ -0,0 +1,158 @@
+/**
+ * [META] 文件头注释扫描器
+ * [WHY] 为 pre-commit 与 CI 提供统一的 [META]/[WHY] 校验逻辑
+ */
+import { readFileSync, readdirSync, statSync } from 'fs';
+import { join, extname } from 'path';
+export const SUPPORTED_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'];
+const DEFAULT_HIGH_RISK_PATTERNS = [
+    /\/orchestrator\//,
+    /\/core\//,
+    /\/types\//,
+    /\.test\.|\.spec\./,
+];
+/**
+ * 扫描文件头注释
+ * @param filePath - 文件路径
+ * @returns 扫描结果
+ */
+export function scanFileHeader(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n').slice(0, 20); // 只检查前 20 行
+    const hasMeta = /\[META\]/i.test(lines.join('\n'));
+    const hasWhy = /\[WHY\]/i.test(lines.join('\n'));
+    // 通用检查：必须有 [META]
+    if (!hasMeta) {
+        return {
+            filePath,
+            valid: false,
+            errorCode: 'E0008',
+            errorMessage: 'File header missing [META] comment. Add [META] metadata in the first 20 lines.',
+            hasMeta: false,
+            hasWhy,
+        };
+    }
+    // 通用检查：必须有 [WHY]
+    if (!hasWhy) {
+        return {
+            filePath,
+            valid: false,
+            errorCode: 'E0009',
+            errorMessage: 'File header missing [WHY] comment. Explain why this file exists in the first 20 lines.',
+            hasMeta,
+            hasWhy: false,
+        };
+    }
+    return {
+        filePath,
+        valid: true,
+        hasMeta,
+        hasWhy,
+    };
+}
+/**
+ * 扫描目录下的所有支持的文件
+ * @param options - 扫描选项
+ * @returns 扫描结果数组
+ */
+export function scanDirectory(options) {
+    const { directory } = options;
+    const results = [];
+    function walkDir(dir) {
+        const entries = readdirSync(dir);
+        for (const entry of entries) {
+            const fullPath = join(dir, entry);
+            const stat = statSync(fullPath);
+            // 跳过 node_modules, .git 等目录
+            if (stat.isDirectory()) {
+                if (entry.startsWith('.') && entry !== '.')
+                    continue;
+                if (entry === 'node_modules')
+                    continue;
+                if (entry === 'dist' || entry === 'build')
+                    continue;
+                if (entry === '__tests__' || entry === 'test')
+                    continue;
+                walkDir(fullPath);
+            }
+            else if (stat.isFile()) {
+                const ext = extname(fullPath);
+                if (SUPPORTED_EXTENSIONS.includes(ext)) {
+                    const result = scanFileHeader(fullPath);
+                    results.push(result);
+                }
+            }
+        }
+    }
+    walkDir(directory);
+    return results;
+}
+/**
+ * 验证并输出结果到控制台
+ */
+export function scanAndPrint(directory) {
+    const results = scanDirectory({ directory });
+    let hasErrors = false;
+    for (const result of results) {
+        if (result.valid) {
+            console.log(`PASS ${result.filePath}: OK [META: ${result.hasMeta}, WHY: ${result.hasWhy}]`);
+        }
+        else {
+            console.error(`ERROR ${result.errorCode}: ${result.filePath}`);
+            console.error(`   ${result.errorMessage}`);
+            hasErrors = true;
+        }
+    }
+    const total = results.length;
+    const valid = results.filter((r) => r.valid).length;
+    console.log(`\nTotal: ${total}, Valid: ${valid}, Invalid: ${total - valid}`);
+    if (hasErrors) {
+        process.exit(1);
+    }
+}
+/**
+ * 评估代码变更的风险
+ * @param changedFiles - 变更的文件列表
+ * @returns 风险评估结果
+ */
+export function assessRisk(changedFiles) {
+    const factors = [];
+    let riskScore = 0;
+    for (const file of changedFiles) {
+        // 检查是否是高风险文件
+        if (DEFAULT_HIGH_RISK_PATTERNS.some((p) => p.test(file))) {
+            riskScore += 2;
+            factors.push(`High-risk file modified: ${file}`);
+        }
+        // 检查是否是测试文件
+        if (/\.test\.|\.spec\./.test(file)) {
+            riskScore += 1;
+            factors.push(`Test file modified: ${file}`);
+        }
+        // 检查是否是配置文件
+        if (/config|\.json$|\.yaml$|\.yml$/.test(file)) {
+            riskScore += 1;
+            factors.push(`Config file modified: ${file}`);
+        }
+    }
+    let level;
+    let confidence;
+    if (riskScore >= 10) {
+        level = 'critical';
+        confidence = 0.95;
+    }
+    else if (riskScore >= 5) {
+        level = 'high';
+        confidence = 0.8;
+    }
+    else if (riskScore >= 2) {
+        level = 'medium';
+        confidence = 0.6;
+    }
+    else {
+        level = 'low';
+        confidence = 0.3;
+    }
+    return { level, confidence, factors };
+}
+//# sourceMappingURL=file-header-scanner.js.map

package/dist/orchestrator/file-header-scanner.js.map

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