speccore 5.4.3 → 5.5.0

package/dist/commands/history.js.map

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

package/dist/commands/impact.d.ts

@@ -0,0 +1,12 @@
+/**
+ * impact - 智能变更影响分析命令
+ * 分析需求/代码变更对上下游的影响范围，生成影响链报告
+ */
+export interface ImpactOptions {
+    req?: string;
+    task?: string;
+    depth?: string;
+    output?: string;
+}
+export declare function impactCommand(options: ImpactOptions): Promise<void>;
+//# sourceMappingURL=impact.d.ts.map

package/dist/commands/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../src/commands/impact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CzE"}

package/dist/commands/impact.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * impact - 智能变更影响分析命令
+ * 分析需求/代码变更对上下游的影响范围，生成影响链报告
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.impactCommand = impactCommand;
+const logger_1 = require("../utils/logger");
+const global_layer_1 = require("../core/global-layer");
+async function impactCommand(options) {
+    if (!options.req && !options.task) {
+        logger_1.logger.error('请提供需求 ID 或 Task 编号。用法: speccore impact --req=<REQ-XXX> 或 --task=<Task-XXX>');
+        return;
+    }
+    const spinner = new logger_1.Spinner('正在构建依赖图...');
+    spinner.start();
+    try {
+        const depth = parseInt(options.depth || '3', 10);
+        const index = await (0, global_layer_1.readGlobalIndex)();
+        // 1. 定位变更源
+        let sourceReq = options.req
+            ? index.reqs.find((r) => r.id === options.req)
+            : undefined;
+        if (options.task && !sourceReq) {
+            // 通过 Task 反查需求
+            sourceReq = index.reqs.find((r) => r.task === options.task);
+        }
+        if (!sourceReq) {
+            const target = options.req || options.task;
+            spinner.fail(`未找到 ${target}`);
+            logger_1.logger.info('请运行 speccore global-status 查看可用需求列表');
+            return;
+        }
+        spinner.stop();
+        // 2. 构建影响链
+        const impacts = await buildImpactChain(sourceReq, index, depth);
+        // 3. 输出报告
+        if (options.output === 'graph') {
+            outputMermaidGraph(sourceReq, impacts);
+        }
+        else {
+            outputImpactReport(sourceReq, impacts);
+        }
+    }
+    catch (error) {
+        spinner.fail(`影响分析失败: ${error}`);
+        throw error;
+    }
+}
+/**
+ * 构建影响链
+ */
+async function buildImpactChain(sourceReq, index, depth) {
+    const projectImpacts = []; // 项目内影响
+    const crossProjectImpacts = []; // 跨项目影响
+    const iterationImpacts = []; // 期次影响
+    const lateralImpacts = []; // 横向关联
+    // 项目内影响（同一项目的其他需求）
+    projectImpacts.push({
+        id: sourceReq.id,
+        name: sourceReq.name,
+        type: 'requirement',
+        relation: '直接关联（变更源）',
+        level: 0,
+    });
+    const sameProjectReqs = index.reqs.filter((r) => r.project === sourceReq.project && r.id !== sourceReq.id);
+    for (const req of sameProjectReqs) {
+        projectImpacts.push({
+            id: req.id,
+            name: req.name,
+            type: 'requirement',
+            relation: req.iteration ? '关联期次' : '同项目',
+            level: 1,
+        });
+    }
+    // 跨项目影响
+    const otherProjectReqs = index.reqs.filter((r) => r.project !== sourceReq.project);
+    const affectedProjects = new Set();
+    for (const req of otherProjectReqs) {
+        affectedProjects.add(req.project);
+    }
+    for (const proj of affectedProjects) {
+        const projReqs = otherProjectReqs.filter((r) => r.project === proj);
+        for (const req of projReqs.slice(0, 3)) {
+            crossProjectImpacts.push({
+                id: req.id,
+                name: req.name,
+                type: 'requirement',
+                relation: `依赖 ${sourceReq.project}`,
+                level: Math.min(2, depth),
+            });
+        }
+    }
+    // 期次影响
+    const relatedIters = index.iterations.filter((iter) => iter.reqs.some((r) => index.reqs
+        .filter((x) => x.project === sourceReq.project)
+        .map((x) => x.id)
+        .includes(r)));
+    for (const iter of relatedIters) {
+        iterationImpacts.push({
+            id: iter.name,
+            name: iter.name,
+            type: 'iteration',
+            relation: iter.status === '🔄 进行中' ? '⚠️ 需回归验证' : '关联',
+            level: 1,
+        });
+    }
+    // 横向关联（同一期次的其他需求）
+    if (sourceReq.iteration) {
+        const iter = index.iterations.find((i) => i.name === sourceReq.iteration);
+        if (iter) {
+            const otherReqs = iter.reqs.filter((r) => r !== sourceReq.id);
+            for (const reqId of otherReqs.slice(0, 5)) {
+                const req = index.reqs.find((r) => r.id === reqId);
+                if (req) {
+                    lateralImpacts.push({
+                        id: req.id,
+                        name: req.name,
+                        type: 'requirement',
+                        relation: '同期次关联',
+                        level: 1,
+                    });
+                }
+            }
+        }
+    }
+    return { projectImpacts, crossProjectImpacts, iterationImpacts, lateralImpacts };
+}
+/**
+ * 输出文字版影响分析报告
+ */
+function outputImpactReport(sourceReq, impacts) {
+    logger_1.logger.info('');
+    logger_1.logger.info('🔗 变更影响分析报告');
+    logger_1.logger.info('');
+    // 变更源
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger_1.logger.info('📌 变更源');
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger_1.logger.info(`   类型: 需求变更`);
+    logger_1.logger.info(`   ID: ${sourceReq.id}`);
+    logger_1.logger.info(`   名称: ${sourceReq.name}`);
+    logger_1.logger.info(`   项目: ${sourceReq.project}`);
+    // 项目内影响
+    logger_1.logger.info('');
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger_1.logger.info('📊 影响链');
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger_1.logger.info(`   📂 项目内影响 (${impacts.projectImpacts.length} 项)`);
+    for (const n of impacts.projectImpacts) {
+        const prefix = n.level === 0 ? '     ★' : '     ├──';
+        logger_1.logger.info(`${prefix} ${n.id} ${n.name} (${n.relation})`);
+    }
+    logger_1.logger.info(`   📂 跨项目影响 (${impacts.crossProjectImpacts.length} 项)`);
+    const crossProjects = new Map();
+    for (const n of impacts.crossProjectImpacts) {
+        const proj = n.relation.replace('依赖 ', '');
+        if (!crossProjects.has(proj))
+            crossProjects.set(proj, []);
+        crossProjects.get(proj).push(n);
+    }
+    for (const [proj, nodes] of crossProjects) {
+        logger_1.logger.info(`   ├── ${proj}`);
+        for (const n of nodes) {
+            logger_1.logger.info(`   │   └── ${n.id} ${n.name}`);
+        }
+    }
+    if (impacts.iterationImpacts.length > 0) {
+        logger_1.logger.info(`   📂 期次影响 (${impacts.iterationImpacts.length} 项)`);
+        for (const n of impacts.iterationImpacts) {
+            logger_1.logger.info(`     ├── ${n.id} ${n.relation}`);
+        }
+    }
+    if (impacts.lateralImpacts.length > 0) {
+        logger_1.logger.info(`   📂 横向关联 (${impacts.lateralImpacts.length} 项)`);
+        for (const n of impacts.lateralImpacts) {
+            logger_1.logger.info(`     ├── ${n.id} ${n.name} (${n.relation})`);
+        }
+    }
+    // 风险等级
+    const totalAffected = impacts.crossProjectImpacts.length +
+        impacts.lateralImpacts.length +
+        impacts.iterationImpacts.filter((i) => i.relation.includes('⚠️')).length;
+    logger_1.logger.info('');
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger_1.logger.info('🚨 风险等级');
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    let riskLevel = '🟢 低风险';
+    if (totalAffected >= 5)
+        riskLevel = '🔴 高风险';
+    else if (totalAffected >= 2)
+        riskLevel = '🟡 中风险';
+    const crossCount = impacts.crossProjectImpacts.length;
+    const iterCount = impacts.iterationImpacts.length;
+    logger_1.logger.info(`   ${riskLevel}: 影响 ${crossCount} 个外部项目，涉及 ${iterCount} 个期次`);
+    // 建议
+    logger_1.logger.info('');
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger_1.logger.info('💡 建议');
+    logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    let idx = 1;
+    if (crossCount > 0) {
+        logger_1.logger.info(`   ${idx++}. ${riskLevel.includes('🔴') ? '🔴' : '🟡'} 优先通知 ${[...new Set(impacts.crossProjectImpacts.map((i) => i.relation.replace('依赖 ', '')))].join(' 和 ')} 团队`);
+    }
+    if (impacts.iterationImpacts.filter((i) => i.relation.includes('⚠️')).length > 0) {
+        logger_1.logger.info(`   ${idx++}. 🔴 对进行中的期次进行回归测试`);
+    }
+    if (impacts.lateralImpacts.length > 0) {
+        logger_1.logger.info(`   ${idx++}. 🟡 建议联合评审 ${sourceReq.id} 和相关需求`);
+    }
+    logger_1.logger.info(`   ${idx++}. 📋 运行 speccore sync-global 同步更新全量层`);
+}
+/**
+ * 输出 Mermaid 依赖图
+ */
+function outputMermaidGraph(sourceReq, impacts) {
+    logger_1.logger.info('');
+    logger_1.logger.info('```mermaid');
+    logger_1.logger.info('graph TD');
+    const srcId = sourceReq.id.replace(/-/g, '');
+    logger_1.logger.info(`    ${srcId}[${sourceReq.id} ${sourceReq.name}]`);
+    for (const n of impacts.projectImpacts.slice(1, 5)) {
+        const nid = n.id.replace(/-/g, '');
+        logger_1.logger.info(`    ${srcId} --> ${nid}[${n.id} ${n.name}]`);
+    }
+    for (const n of impacts.crossProjectImpacts.slice(0, 5)) {
+        const nid = n.id.replace(/-/g, '');
+        const projNode = n.relation.replace('依赖 ', '').replace(/-/g, '');
+        logger_1.logger.info(`    ${srcId} --> ${projNode}[${n.relation.replace('依赖 ', '')}]`);
+        logger_1.logger.info(`    ${projNode} --> ${nid}[${n.id} ${n.name}]`);
+    }
+    for (const n of impacts.iterationImpacts) {
+        const nid = n.id.replace(/-/g, '').replace(/[^a-zA-Z0-9]/g, '');
+        logger_1.logger.info(`    ${srcId} --> ITER_${nid}[${n.id}]`);
+    }
+    logger_1.logger.info('```');
+}
+//# sourceMappingURL=impact.js.map

package/dist/commands/impact.js.map

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

package/dist/commands/index-update.d.ts

@@ -0,0 +1,8 @@
+/**
+ * index-update — 扫描 GLOBAL/PROJECTS/ 下所有项目需求，自动重建 GLOBAL/INDEX.md
+ */
+export interface IndexUpdateOptions {
+    dryRun?: boolean;
+}
+export declare function indexUpdateCommand(options: IndexUpdateOptions): Promise<void>;
+//# sourceMappingURL=index-update.d.ts.map

package/dist/commands/index-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-update.d.ts","sourceRoot":"","sources":["../../src/commands/index-update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuGnF"}

package/dist/commands/index-update.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * index-update — 扫描 GLOBAL/PROJECTS/ 下所有项目需求，自动重建 GLOBAL/INDEX.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexUpdateCommand = indexUpdateCommand;
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+const global_layer_1 = require("../core/global-layer");
+async function indexUpdateCommand(options) {
+    const spinner = new logger_1.Spinner('Scanning requirements and rebuilding index');
+    spinner.start();
+    try {
+        const globalDir = (0, path_1.join)(process.cwd(), '.speccore', 'GLOBAL');
+        if (!(await (0, fs_extra_1.pathExists)(globalDir))) {
+            spinner.fail('Global layer not initialized. Run: speccore init');
+            return;
+        }
+        const projectsDir = (0, path_1.join)(globalDir, 'PROJECTS');
+        if (!(await (0, fs_extra_1.pathExists)(projectsDir))) {
+            spinner.fail('No projects found in GLOBAL/PROJECTS/');
+            return;
+        }
+        const index = await (0, global_layer_1.readGlobalIndex)();
+        const today = new Date().toISOString().split('T')[0];
+        // 扫描所有项目
+        const projects = await scanAllProjects(projectsDir);
+        // 收集所有需求
+        const allReqs = [];
+        let totalReqs = 0;
+        let newReqs = 0;
+        let updatedReqs = 0;
+        const currentReqIds = new Set();
+        for (const proj of projects) {
+            // 提取 REQ-XXX 条目
+            const reqContent = await (0, fs_extra_1.readFile)((0, path_1.join)(projectsDir, proj, 'REQUIREMENT.md'), 'utf-8');
+            const reqMatches = reqContent.matchAll(/### (REQ-\d+).*\n([\s\S]*?)(?=### REQ-\d+|$)/g);
+            for (const match of reqMatches) {
+                const reqId = match[1];
+                const reqBody = match[2];
+                currentReqIds.add(reqId);
+                totalReqs++;
+                // 从 GLOBAL/INDEX 查找现有状态
+                const existingEntry = index.reqs?.find((r) => r.id === reqId);
+                const name = extractField(reqBody, '需求名称') || proj;
+                const status = extractField(reqBody, '状态') || '📝 待开发';
+                const version = extractField(reqBody, '版本') || 'v1.0';
+                allReqs.push({ id: reqId, project: proj, name, status, version });
+                if (!existingEntry) {
+                    newReqs++;
+                }
+                else if (existingEntry.status !== status ||
+                    existingEntry.name !== name) {
+                    updatedReqs++;
+                }
+            }
+        }
+        // 重建 INDEX.md
+        if (!options.dryRun) {
+            await rebuildIndex(globalDir, allReqs, projects, totalReqs, today);
+        }
+        spinner.stop(options.dryRun ? 'Dry run completed (no changes made)' : 'Index rebuilt successfully');
+        logger_1.logger.info('');
+        logger_1.logger.info('📊 扫描结果：');
+        logger_1.logger.info(`  项目数：${projects.length} 个`);
+        logger_1.logger.info(`  需求数：${totalReqs} 条`);
+        if (!options.dryRun) {
+            logger_1.logger.info(`  新增需求：${newReqs} 条`);
+            logger_1.logger.info(`  状态更新：${updatedReqs} 条`);
+            logger_1.logger.info('');
+            logger_1.logger.info('✅ GLOBAL/INDEX.md 已更新！');
+        }
+        else {
+            logger_1.logger.info('');
+            logger_1.logger.info('💡 预览模式（--dry-run），索引未被实际修改。');
+            logger_1.logger.info('   去除 --dry-run 执行实际更新。');
+        }
+        // 列出项目摘要
+        logger_1.logger.info('');
+        logger_1.logger.info('📁 项目摘要：');
+        for (const proj of projects) {
+            const reqCount = allReqs.filter((r) => r.project === proj).length;
+            logger_1.logger.info(`  - ${proj}: ${reqCount} 个需求`);
+        }
+    }
+    catch (error) {
+        spinner.fail(`Index update failed: ${error}`);
+        throw error;
+    }
+}
+/**
+ * 扫描 GLOBAL/PROJECTS/ 下所有项目
+ */
+async function scanAllProjects(projectsDir) {
+    const projects = [];
+    if (!(await (0, fs_extra_1.pathExists)(projectsDir)))
+        return projects;
+    const entries = await (0, fs_extra_1.readdir)(projectsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('_')) {
+            const reqPath = (0, path_1.join)(projectsDir, entry.name, 'REQUIREMENT.md');
+            if (await (0, fs_extra_1.pathExists)(reqPath)) {
+                projects.push(entry.name);
+            }
+        }
+    }
+    return projects;
+}
+/**
+ * 从 markdown 正文中提取字段
+ */
+function extractField(body, field) {
+    const patterns = [
+        new RegExp(`\\*\\*${field}\\*\\*\\s*[：:]\\s*([^\\n]+)`, 'i'),
+        new RegExp(`\\|\\s*${field}\\s*\\|\\s*([^\\|]+)\\|`, 'i'),
+    ];
+    for (const pattern of patterns) {
+        const match = body.match(pattern);
+        if (match)
+            return match[1].trim();
+    }
+    return null;
+}
+/**
+ * 重建 INDEX.md
+ */
+async function rebuildIndex(globalDir, reqs, projects, totalReqs, today) {
+    const indexPath = (0, path_1.join)(globalDir, 'INDEX.md');
+    // 按需求 ID 排序
+    reqs.sort((a, b) => a.id.localeCompare(b.id));
+    let content = `# 全量需求索引（Global Catalog）
+
+> 本文件是需求定位的"地图"。具体需求内容请查看各项目的 \`PROJECTS/{项目名}/REQUIREMENT.md\`。
+> 本文件由 \`speccore import\` 和 \`speccore index-update\` 自动维护，请勿手动编辑。
+
+---
+
+## 需求索引
+
+| 需求 ID | 项目 | 需求名称 | 状态 | 版本 | 文件路径 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+`;
+    if (reqs.length === 0) {
+        content += '| _暂无需求_ | - | - | - | - | - |\n';
+    }
+    else {
+        for (const req of reqs) {
+            content += `| ${req.id} | ${req.project} | ${req.name} | ${req.status} | ${req.version} | GLOBAL/PROJECTS/${req.project}/REQUIREMENT.md |\n`;
+        }
+    }
+    content += `
+---
+
+## 项目列表
+
+| 项目名称 | 需求数 | 状态 | 最后更新 |
+| :--- | :--- | :--- | :--- |
+`;
+    if (projects.length === 0) {
+        content += '| _暂无项目_ | - | - | - |\n';
+    }
+    else {
+        for (const proj of projects) {
+            const reqCount = reqs.filter((r) => r.project === proj).length;
+            content += `| ${proj} | ${reqCount} | 活跃 | ${today} |\n`;
+        }
+    }
+    content += `
+---
+
+## 版本信息
+
+| 版本 | 日期 | 变更说明 |
+| :--- | :--- | :--- |
+| v1.0 | ${today} | 由 speccore index-update 自动重建 |
+`;
+    await (0, fs_extra_1.writeFile)(indexPath, content);
+}
+//# sourceMappingURL=index-update.js.map

package/dist/commands/index-update.js.map

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

package/dist/commands/iteration-from-global.d.ts

@@ -0,0 +1,11 @@
+/**
+ * iteration-from-global - 从全量层生成期次命令
+ * 从 GLOBAL/INDEX.md 查找需求 ID，定位到对应项目 REQUIREMENT.md 提取需求，生成新的期次
+ */
+export interface IterationFromGlobalOptions {
+    reqs?: string;
+    name?: string;
+    force?: boolean;
+}
+export declare function iterationFromGlobalCommand(options: IterationFromGlobalOptions): Promise<void>;
+//# sourceMappingURL=iteration-from-global.d.ts.map

package/dist/commands/iteration-from-global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iteration-from-global.d.ts","sourceRoot":"","sources":["../../src/commands/iteration-from-global.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAqInG"}