speccore 5.15.1 → 5.19.0

package/dist/core/intent-ai.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiEnhance = aiEnhance;
+exports.recognizeWithAi = recognizeWithAi;
+const logger_1 = require("../utils/logger");
+/**
+ * 用 AI 增强意图识别（当关键词匹配不可靠时）
+ * 利用本地 AI/WorkBuddy 的分析能力
+ */
+async function aiEnhance(input, keywordConfidence) {
+    // 只有低置信度时才启动 AI
+    if (keywordConfidence >= 50)
+        return null;
+    logger_1.logger.info('  🤖 关键词置信度偏低，启用 AI 分析...');
+    try {
+        const prompt = buildAiPrompt(input);
+        const response = await callLocalAi(prompt);
+        return parseAiResponse(response);
+    }
+    catch (error) {
+        // AI 不可用时静默降级
+        return null;
+    }
+}
+function buildAiPrompt(input) {
+    return `分析以下中文描述，判断用户想执行什么操作。只返回 JSON。
+
+描述: "${input}"
+
+可用的操作类型:
+- change: 修改/调整已有功能或需求
+- bugfix: 修复错误/Bug
+- new_task: 新增功能或任务
+- execute: 执行/开发/开始干活
+- review: 审查/检查
+- query_progress: 查看进度/状态
+- research: 技术调研/方案评估
+- help: 求助/帮助
+
+返回格式（仅 JSON，不要其他内容）:
+{
+  "intent": "操作类型",
+  "confidence": 0-100,
+  "suggestion": "建议的 speccore 命令",
+  "explanation": "简短解释"
+}`;
+}
+function callLocalAi(prompt) {
+    try {
+        // 尝试通过 WorkBuddy 的 AI 能力（进程内调用）
+        // fallback: 基于规则给出合理建议
+        throw new Error('use fallback');
+    }
+    catch {
+        // 无 AI 可用时，基于关键词深度分析
+        return fallbackAnalysis(prompt);
+    }
+}
+function fallbackAnalysis(prompt) {
+    // 提取描述部分
+    const match = prompt.match(/描述: "(.+)"/);
+    const input = match ? match[1] : '';
+    // 深度关键词分析（比 intent-recognition 更精细）
+    const hasProblem = /出问题|报错|挂了|崩了|不行|不正常|超时|500|异常|错误/.test(input);
+    const hasChange = /改|调整|换成|替换|修改|优化/.test(input);
+    const hasNew = /新增|添加|加一个|创建一个|开发|做一个/.test(input);
+    const hasQuery = /多少|进度|状态|怎么|哪些|看看|查看/.test(input);
+    let intent = 'help';
+    let confidence = 30;
+    let suggestion = 'speccore spec "..."';
+    let explanation = '无法确定意图，请用 /spec 命令明确说明';
+    if (hasProblem && !hasChange && !hasNew) {
+        intent = 'bugfix';
+        confidence = 55;
+        suggestion = 'speccore bugfix --name="自动检测的Bug"';
+        explanation = `检测到问题描述（"${matchExtract(input, /(?:出问题|报错|挂了|崩了|超时|500)/)}"），建议创建 Bug 修复任务`;
+    }
+    else if (hasChange && !hasProblem) {
+        intent = 'change';
+        confidence = 60;
+        suggestion = 'speccore change';
+        explanation = '检测到修改意图，建议使用需求变更';
+    }
+    else if (hasNew && !hasProblem) {
+        intent = 'new_task';
+        confidence = 60;
+        suggestion = 'speccore new-task';
+        explanation = '检测到新增意图，建议创建新任务';
+    }
+    else if (hasQuery) {
+        intent = 'query_progress';
+        confidence = 55;
+        suggestion = 'speccore status';
+        explanation = '检测到查询意图';
+    }
+    return JSON.stringify({ intent, confidence, suggestion, explanation });
+}
+function matchExtract(input, pattern) {
+    const m = input.match(pattern);
+    return m ? m[0] : '';
+}
+function parseAiResponse(response) {
+    try {
+        // 尝试从 markdown 代码块中提取 JSON
+        const jsonMatch = response.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+        const jsonStr = jsonMatch ? jsonMatch[1] : response;
+        const parsed = JSON.parse(jsonStr.trim());
+        return {
+            intent: parsed.intent || 'help',
+            confidence: Math.min(100, Math.max(0, Number(parsed.confidence) || 30)),
+            suggestion: parsed.suggestion || '',
+            explanation: parsed.explanation || '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 统一入口：关键词 + AI 增强
+ */
+async function recognizeWithAi(input, keywordResults) {
+    const topConfidence = keywordResults[0]?.confidence || 0;
+    const secondConfidence = keywordResults[1]?.confidence || 0;
+    const gap = topConfidence - secondConfidence;
+    // 不需要 AI：高置信度 + 差距明显
+    if (topConfidence >= 50 && gap >= 20) {
+        return { final: keywordResults[0], usedAi: false };
+    }
+    // 调用 AI 增强
+    const aiResult = await aiEnhance(input, topConfidence);
+    if (aiResult && aiResult.confidence > topConfidence) {
+        logger_1.logger.info(`  🤖 AI 判断: ${aiResult.intent} (${aiResult.confidence}%) — ${aiResult.explanation}`);
+        return { final: { ...keywordResults[0], ...aiResult, aiEnhanced: true }, usedAi: true };
+    }
+    return { final: keywordResults[0], usedAi: false };
+}
+//# sourceMappingURL=intent-ai.js.map

package/dist/core/intent-ai.js.map

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

package/dist/core/requirement-tracker.d.ts

@@ -0,0 +1,24 @@
+export interface ReqEntry {
+    id: string;
+    title: string;
+    status: 'active' | 'modified' | 'deprecated';
+    originIteration: string;
+    lastModifiedIteration?: string;
+    changeHistory: {
+        iteration: string;
+        type: '新增' | '修改' | '废弃';
+        timestamp: string;
+    }[];
+}
+export declare function loadTracker(): Promise<ReqEntry[]>;
+export declare function saveTracker(entries: ReqEntry[]): Promise<void>;
+/**
+ * 注册或更新需求追踪
+ * @returns warnings — 跨期次冲突预警
+ */
+export declare function registerRequirement(title: string, iteration: string, changeType: '新增' | '修改' | '废弃'): Promise<string[]>;
+/**
+ * 生成全量层需求追踪报告 (Markdown)
+ */
+export declare function generateTrackerReport(): Promise<string>;
+//# sourceMappingURL=requirement-tracker.d.ts.map

package/dist/core/requirement-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-tracker.d.ts","sourceRoot":"","sources":["../../src/core/requirement-tracker.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrF;AAQD,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMvD;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAiDnB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAc7D"}

package/dist/core/requirement-tracker.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTracker = loadTracker;
+exports.saveTracker = saveTracker;
+exports.registerRequirement = registerRequirement;
+exports.generateTrackerReport = generateTrackerReport;
+/**
+ * requirement-tracker — 全量层需求追踪：新增/修改/冲突检测
+ */
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const TRACKER_PATH = (0, path_1.join)('.speccore', 'GLOBAL', 'REQUIREMENTS', 'tracker.json');
+function trackerPath() {
+    return (0, path_1.join)(process.cwd(), TRACKER_PATH);
+}
+async function loadTracker() {
+    const p = trackerPath();
+    if (await (0, fs_extra_1.pathExists)(p)) {
+        return JSON.parse(await (0, fs_extra_1.readFile)(p, 'utf-8'));
+    }
+    return [];
+}
+async function saveTracker(entries) {
+    const p = trackerPath();
+    await (0, fs_extra_1.ensureDir)((0, path_1.join)(p, '..'));
+    await (0, fs_extra_1.writeFile)(p, JSON.stringify(entries, null, 2), 'utf-8');
+}
+/**
+ * 注册或更新需求追踪
+ * @returns warnings — 跨期次冲突预警
+ */
+async function registerRequirement(title, iteration, changeType) {
+    const entries = await loadTracker();
+    const warnings = [];
+    // 按标题模糊匹配已有需求（前 10 字相同视为同一需求）
+    const existing = entries.find(e => e.title.slice(0, Math.min(10, e.title.length, title.length)) ===
+        title.slice(0, Math.min(10, title.length)));
+    const now = new Date().toISOString();
+    if (existing) {
+        if (changeType === '新增') {
+            warnings.push(`⚠️ "${title}" 已在 ${existing.originIteration} 中引入，当前标记为「新增」可能重复`);
+        }
+        if (changeType === '修改') {
+            existing.status = 'modified';
+            existing.lastModifiedIteration = iteration;
+            existing.changeHistory.push({ iteration, type: '修改', timestamp: now });
+            // 检测：是否有其他期次也在修改同一个需求
+            const otherModifiers = existing.changeHistory
+                .filter(h => h.type === '修改' && h.iteration !== iteration)
+                .map(h => h.iteration);
+            if (otherModifiers.length > 0) {
+                warnings.push(`⚠️ "${title}" 曾在以下期次被修改: ${[...new Set(otherModifiers)].join(', ')} — 注意合并冲突`);
+            }
+        }
+        if (changeType === '废弃') {
+            existing.status = 'deprecated';
+            existing.changeHistory.push({ iteration, type: '废弃', timestamp: now });
+        }
+    }
+    else {
+        // 新需求
+        entries.push({
+            id: `REQ-${String(entries.length + 1).padStart(3, '0')}`,
+            title,
+            status: changeType === '废弃' ? 'deprecated' : 'active',
+            originIteration: iteration,
+            changeHistory: [{ iteration, type: '新增', timestamp: now }],
+        });
+    }
+    await saveTracker(entries);
+    return warnings;
+}
+/**
+ * 生成全量层需求追踪报告 (Markdown)
+ */
+async function generateTrackerReport() {
+    const entries = await loadTracker();
+    let report = `# 全量需求追踪\n\n`;
+    report += `> 自动生成 | ${new Date().toISOString().slice(0, 10)}\n\n`;
+    report += `| ID | 需求 | 状态 | 首次期次 | 最近修改 | 变更次数 |\n`;
+    report += `| :--- | :--- | :--- | :--- | :--- | :--- |\n`;
+    for (const e of entries) {
+        const statusEmoji = e.status === 'active' ? '🟢' : e.status === 'modified' ? '🟡' : '⚫';
+        report += `| ${e.id} | ${e.title} | ${statusEmoji} ${e.status} | ${e.originIteration} | ${e.lastModifiedIteration || '-'} | ${e.changeHistory.length} |\n`;
+    }
+    return report;
+}
+//# sourceMappingURL=requirement-tracker.js.map

package/dist/core/requirement-tracker.js.map

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

package/dist/core/risk-scorer.d.ts

@@ -1,14 +1,24 @@
-/**
- * risk-scorer — 任务风险评分 + 标签
- */
+export interface RiskItem {
+    category: string;
+    level: '🔴' | '🟡' | '🟢';
+    description: string;
+    mitigation: string;
+    source: '需求' | '源码';
+}
 export interface RiskScore {
     level: '🔴 high' | '🟡 medium' | '🟢 low';
     score: number;
     tags: string[];
     reasons: string[];
+    items: RiskItem[];
+    codeRisks: RiskItem[];
 }
 /**
- * 根据任务需求内容自动评分
+ * 根据任务需求内容 + 已有源码自动评分
+ */
+export declare function scoreRisk(content: string, taskName: string, iterationDir?: string): Promise<RiskScore>;
+/**
+ * 生成详细风险报告（Markdown）
  */
-export declare function scoreRisk(content: string, taskName: string): RiskScore;
+export declare function generateRiskReport(risk: RiskScore): string;
 //# sourceMappingURL=risk-scorer.d.ts.map

package/dist/core/risk-scorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"risk-scorer.d.ts","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CA2DtE"}
+{"version":3,"file":"risk-scorer.d.ts","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA4H5G;AA+CD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAsB1D"}

package/dist/core/risk-scorer.js

@@ -1,61 +1,190 @@
 "use strict";
-/**
- * risk-scorer — 任务风险评分 + 标签
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scoreRisk = scoreRisk;
+exports.generateRiskReport = generateRiskReport;
+/**
+ * risk-scorer — 任务风险评分 + 详细报告
+ */
+const fs_extra_1 = require("fs-extra");
 /**
- * 根据任务需求内容自动评分
+ * 根据任务需求内容 + 已有源码自动评分
  */
-function scoreRisk(content, taskName) {
+async function scoreRisk(content, taskName, iterationDir) {
     let score = 0;
     const tags = [];
     const reasons = [];
+    const items = [];
     // ── 高风险: 支付/资金 ──
     if (content.match(/支付|退款|转账|提现|余额|钱包|金额|价格|账单/)) {
         score += 30;
         tags.push('💰 支付');
         reasons.push('涉及支付/资金操作');
+        items.push({
+            category: '支付安全',
+            level: '🔴',
+            description: '涉及资金交易，任何错误都可能导致资损',
+            mitigation: '必须双人审查 + 充分测试覆盖 + 添加资金操作日志',
+            source: '需求',
+        });
     }
     // ── 高风险: 权限/认证 ──
     if (content.match(/权限|角色|RBAC|认证|授权|登录|token|OAuth|JWT|鉴权/)) {
         score += 25;
         tags.push('🔐 权限');
         reasons.push('涉及权限/认证变更');
+        items.push({
+            category: '权限控制',
+            level: '🔴',
+            description: '权限变更可能造成越权访问',
+            mitigation: '逐接口检查权限注解 + 补充越权测试用例',
+            source: '需求',
+        });
+    }
+    // ── 高风险: 数据删除 ──
+    if (content.match(/DELETE\s*\|/) || content.match(/物理删除|硬删除|cascade/)) {
+        score += 20;
+        items.push({
+            category: '数据安全',
+            level: '🔴',
+            description: '物理删除操作不可逆',
+            mitigation: '建议改用软删除 + 回收站机制, 生产环境禁止物理删除',
+            source: '需求',
+        });
     }
     // ── 中风险: 批量操作 ──
     if (content.match(/批量删除|批量操作|批量导入|批量更新|全选/)) {
         score += 20;
         tags.push('📦 批量');
         reasons.push('批量操作有数据风险');
+        items.push({
+            category: '批量操作',
+            level: '🟡',
+            description: '批量操作可能影响大量数据',
+            mitigation: '添加批量限制(≤1000) + 异步处理 + 操作确认弹窗',
+            source: '需求',
+        });
     }
     // ── 中风险: 导出/报表 ──
     if (content.match(/导出|报表|Excel|CSV|下载|文件生成/)) {
         score += 15;
         tags.push('📊 导出');
         reasons.push('大数据量导出需注意性能');
+        items.push({
+            category: '性能',
+            level: '🟡',
+            description: '大数据量导出可能拖垮服务',
+            mitigation: '异步导出 + 分页查询 + 文件压缩 + 24h自动清理',
+            source: '需求',
+        });
     }
     // ── 中风险: 涉及数据库变更 ──
     if (content.match(/数据表|ALTER|建表|索引|迁移|数据迁移|DDL/)) {
         score += 15;
         tags.push('🗄️ DB');
         reasons.push('涉及数据库结构变更');
+        items.push({
+            category: '数据库变更',
+            level: '🟡',
+            description: '数据库结构变更可能影响已有功能',
+            mitigation: '先在测试环境验证 + 写好回滚脚本 + 非高峰期执行',
+            source: '需求',
+        });
     }
     // ── 中风险: 外部依赖 ──
     if (content.match(/第三方|外部API|回调|webhook|消息队列|Kafka|MQ/)) {
         score += 10;
         tags.push('🔗 外部依赖');
         reasons.push('涉及外部系统集成');
+        items.push({
+            category: '外部依赖',
+            level: '🟡',
+            description: '外部系统不可用时本功能也会受影响',
+            mitigation: '添加超时(5s) + 熔断降级 + 重试机制 + 监控告警',
+            source: '需求',
+        });
     }
     // ── 低风险标记 ──
     const crud = content.match(/\| (GET|POST|PUT|DELETE) \|/) || [];
     if (crud.length >= 2 && score < 20) {
         tags.push('📋 CRUD');
+        items.push({
+            category: '通用 CRUD',
+            level: '🟢',
+            description: '标准增删改查，风险较低',
+            mitigation: '注意输入校验 + 异常处理',
+            source: '需求',
+        });
     }
     if (score < 15) {
         tags.push('🟢 低风险');
     }
+    // ── 源码层面的风险检测 ──
+    const codeRisks = await detectCodeRisks(iterationDir, taskName);
     const level = score >= 30 ? '🔴 high' : score >= 15 ? '🟡 medium' : '🟢 low';
-    return { level, score, tags, reasons };
+    return { level, score, tags, reasons, items, codeRisks };
+}
+/**
+ * 检测源码层面的风险（从已有关联代码中分析）
+ */
+async function detectCodeRisks(iterationDir, taskName) {
+    if (!iterationDir || !taskName)
+        return [];
+    const risks = [];
+    // 检查 TECH.md 中的选型是否有已知风险
+    const techPath = `.speccore/iterations/${iterationDir}/${taskName}/backend/TECH.md`;
+    const altTechPath = `${iterationDir}/${taskName}/backend/TECH.md`;
+    let techContent = '';
+    try {
+        if (await (0, fs_extra_1.pathExists)(techPath))
+            techContent = await (0, fs_extra_1.readFile)(techPath, 'utf-8');
+        else if (await (0, fs_extra_1.pathExists)(altTechPath))
+            techContent = await (0, fs_extra_1.readFile)(altTechPath, 'utf-8');
+    }
+    catch { }
+    if (techContent) {
+        // 检测到 N+1 查询风险
+        if (techContent.match(/for\s*\(.*\)\s*\{|forEach.*\.find|循环.*查询/)) {
+            risks.push({
+                category: '性能',
+                level: '🟡',
+                description: '代码中可能存在 N+1 查询问题',
+                mitigation: '使用 JOIN 查询或批量查询代替循环中的单条查询',
+                source: '源码',
+            });
+        }
+        // 检测到未处理的异常
+        if (techContent.match(/\.catch\s*\(\s*\)|catch\s*\{\s*\}/)) {
+            risks.push({
+                category: '异常处理',
+                level: '🟡',
+                description: '存在空异常捕获，可能吞掉错误信息',
+                mitigation: '添加错误日志记录 + 统一异常处理中间件',
+                source: '源码',
+            });
+        }
+    }
+    return risks;
+}
+/**
+ * 生成详细风险报告（Markdown）
+ */
+function generateRiskReport(risk) {
+    let md = `# 风险评估\n\n`;
+    md += `- **风险等级**: ${risk.level}\n`;
+    md += `- **风险评分**: ${risk.score}/100\n`;
+    md += `- **风险标签**: ${risk.tags.join(', ') || '无'}\n\n`;
+    const allItems = [...risk.items, ...risk.codeRisks];
+    if (allItems.length === 0) {
+        md += '✅ 未检测到明显风险\n';
+        return md;
+    }
+    md += `## 风险详情 (${allItems.length} 项)\n\n`;
+    md += `| 等级 | 类别 | 描述 | 缓解建议 | 来源 |\n`;
+    md += `| :--- | :--- | :--- | :--- | :--- |\n`;
+    for (const item of allItems) {
+        md += `| ${item.level} | ${item.category} | ${item.description} | ${item.mitigation} | ${item.source} |\n`;
+    }
+    md += `\n---\n> 💡 高风险项建议在开发前 Review，中风险项开发时注意缓解措施\n`;
+    return md;
 }
 //# sourceMappingURL=risk-scorer.js.map

package/dist/core/risk-scorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"risk-scorer.js","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,8BA2DC;AA9DD;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAe,EAAE,QAAgB;IACzD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,EAAE,CAAC;QAC5D,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC5C,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC7C,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACjD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,EAAE,CAAC;QACxD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,cAAc;IACd,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC"}
+{"version":3,"file":"risk-scorer.js","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":"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"}

package/dist/core/spec-annotations.d.ts

@@ -0,0 +1,35 @@
+export interface SpecAnnotation {
+    type: 'module' | 'api' | 'entity' | 'dependency' | 'scope';
+    value: string;
+    file: string;
+    line: number;
+}
+export interface ModuleGroup {
+    name: string;
+    directory: string;
+    files: string[];
+    apis: string[];
+    entities: string[];
+    dependencies: string[];
+}
+/**
+ * 扫描单个文件的 Spec 注释标记
+ */
+export declare function extractAnnotations(filePath: string): Promise<SpecAnnotation[]>;
+/**
+ * 从注释标记构建模块分组
+ */
+export declare function buildModuleGroups(annotations: SpecAnnotation[]): ModuleGroup[];
+/**
+ * 根据需求描述查找对应模块（用于精准读取）
+ */
+export declare function matchModule(requirement: string, modules: ModuleGroup[]): ModuleGroup | null;
+/**
+ * 自动发现项目根目录（多工程场景）
+ */
+export declare function discoverProjectRoots(cwd: string): Promise<string[]>;
+/**
+ * 生成模块清单报告
+ */
+export declare function generateModuleReport(modules: ModuleGroup[]): string;
+//# sourceMappingURL=spec-annotations.d.ts.map

package/dist/core/spec-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-annotations.d.ts","sourceRoot":"","sources":["../../src/core/spec-annotations.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAiBD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwBpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CAkD9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EAAE,GACrB,WAAW,GAAG,IAAI,CAoBpB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAiBnE"}