speccore 5.4.3 → 5.5.0

package/dist/commands/goal.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * goal - 完整需求交付命令
+ * 从需求描述出发，自动创建任务并生成完整的 Spec 文档结构
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goalCommand = goalCommand;
+const logger_1 = require("../utils/logger");
+const context_1 = require("../core/context");
+const fs_extra_1 = require("fs-extra");
+const task_utils_1 = require("../utils/task-utils");
+const path_1 = require("path");
+async function goalCommand(options) {
+    if (!options.name && !options.desc) {
+        logger_1.logger.error('请提供功能名称或描述。用法: speccore goal --name "<功能名>" [--desc "<描述>"]');
+        return;
+    }
+    const spinner = new logger_1.Spinner('正在创建完整需求交付...');
+    spinner.start();
+    try {
+        const iteration = await (0, context_1.getDefaultIteration)(options.iteration);
+        if (!iteration) {
+            spinner.fail('未找到活跃期次。请先运行: speccore iteration create --name <名称>');
+            return;
+        }
+        const taskName = options.name || '新功能';
+        const taskType = options.type || 'feature';
+        const taskId = options.taskId || await (0, task_utils_1.generateTaskId)(iteration);
+        const taskDir = (0, path_1.join)(iteration, taskId);
+        // 创建任务目录结构
+        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend'));
+        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'frontend'));
+        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '_shared'));
+        // 创建 .task-type
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.task-type'), taskType);
+        // 生成后端 Spec 文件
+        if (!options.frontendOnly) {
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'REQ.md'), generateBackendReq(taskName, options.desc || ''));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'TECH.md'), generateBackendTech(taskName, options.desc || ''));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'TASK.md'), generateTask(taskName, taskType, options.desc || ''));
+        }
+        // 生成前端 Spec 文件
+        if (!options.backendOnly) {
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'frontend', 'REQ.md'), generateFrontendReq(taskName, options.desc || ''));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'frontend', 'TECH.md'), generateFrontendTech(taskName, options.desc || ''));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'frontend', 'TASK.md'), generateTask(taskName, taskType, options.desc || ''));
+        }
+        // 生成 API 契约
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'API_CONTRACT.yaml'), generateApiContract(taskName, options.desc || ''));
+        spinner.stop(`需求交付已创建: ${taskId}`);
+        logger_1.logger.info('');
+        logger_1.logger.info(`📋 任务详情:`);
+        logger_1.logger.info(`   期次: ${iteration}`);
+        logger_1.logger.info(`   任务: ${taskId} - ${taskName}`);
+        logger_1.logger.info(`   类型: ${taskType}`);
+        if (options.desc) {
+            logger_1.logger.info(`   描述: ${options.desc}`);
+        }
+        logger_1.logger.info('');
+        logger_1.logger.info('下一步:');
+        logger_1.logger.info(`  1. 编辑 ${taskId}/backend/REQ.md 补充需求细节`);
+        logger_1.logger.info(`  2. 编辑 ${taskId}/backend/TECH.md 完善技术方案`);
+        logger_1.logger.info('  3. 运行: speccore execute --all');
+    }
+    catch (error) {
+        spinner.fail(`需求交付创建失败: ${error}`);
+        throw error;
+    }
+}
+function generateBackendReq(name, desc) {
+    return `# ${name} - 后端需求
+
+## 1. 需求描述
+
+${desc || '请补充功能描述'}
+
+## 2. 业务规则
+
+1. 
+2. 
+
+## 3. 验收标准
+
+- [ ] 
+- [ ] 
+
+## 4. 非功能需求
+
+- 性能：
+- 安全：
+- 可用性：
+`;
+}
+function generateBackendTech(name, desc) {
+    return `# ${name} - 后端技术方案
+
+## 1. 方案概述
+
+${desc || '请补充技术方案概述'}
+
+## 2. 核心设计
+
+### 2.1 接口设计
+
+| 方法 | 路径 | 说明 |
+| :--- | :--- | :--- |
+| | | |
+
+### 2.2 数据模型
+
+\`\`\`
+（请补充数据模型）
+\`\`\`
+
+## 3. 技术决策
+
+| 决策项 | 方案 | 理由 |
+| :--- | :--- | :--- |
+| | | |
+`;
+}
+function generateFrontendReq(name, desc) {
+    return `# ${name} - 前端需求
+
+## 1. 页面描述
+
+${desc || '请补充页面功能描述'}
+
+## 2. 交互流程
+
+1. 
+2. 
+
+## 3. UI 要求
+
+- 
+- 
+
+## 4. 验收标准
+
+- [ ] 
+- [ ] 
+`;
+}
+function generateFrontendTech(name, desc) {
+    return `# ${name} - 前端技术方案
+
+## 1. 方案概述
+
+${desc || '请补充前端技术方案概述'}
+
+## 2. 组件设计
+
+### 2.1 组件树
+
+\`\`\`
+（请补充组件树结构）
+\`\`\`
+
+### 2.2 状态管理
+
+\`\`\`
+（请补充状态设计）
+\`\`\`
+
+## 3. 技术决策
+
+| 决策项 | 方案 | 理由 |
+| :--- | :--- | :--- |
+| | | |
+`;
+}
+function generateTask(name, type, desc) {
+    const now = new Date().toISOString().split('T')[0];
+    return `# ${name} - 执行追踪
+
+> **任务类型**: ${type} | **创建日期**: ${now} | **状态**: 🔲 待开发
+
+## 1. 变更履历
+
+| 日期 | 版本 | 变更说明 | 作者 |
+| :--- | :--- | :--- | :--- |
+| ${now} | v1.0 | 初始创建 | SpecCore |
+
+## 2. 任务描述
+
+${desc || '请补充任务描述'}
+
+## 3. 子任务
+
+- [ ] 需求分析
+- [ ] 方案设计
+- [ ] 编码实现
+- [ ] 测试验证
+- [ ] 代码审查
+
+## 4. 产出物清单
+
+| 产出物 | 路径 | 状态 |
+| :--- | :--- | :--- |
+| | | |
+`;
+}
+function generateApiContract(name, desc) {
+    return `# ${name} - API 契约
+# OpenAPI 3.0.3
+openapi: "3.0.3"
+info:
+  title: ${name}
+  description: ${desc || '请补充接口描述'}
+  version: "1.0.0"
+
+paths:
+  # 请在此定义 API 路径
+  # /api/v1/resource:
+  #   post:
+  #     summary: 
+  #     requestBody:
+  #       content:
+  #         application/json:
+  #           schema:
+  #             type: object
+  #     responses:
+  #       '200':
+  #         description: 成功
+
+components:
+  schemas:
+    # 请在此定义数据模型
+`;
+}
+//# sourceMappingURL=goal.js.map

package/dist/commands/goal.js.map

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

package/dist/commands/handover.d.ts

@@ -0,0 +1,11 @@
+/**
+ * handover - 生成交接文档命令
+ * 汇总期次关键信息、待办事项和风险点
+ */
+export interface HandoverOptions {
+    iteration?: string;
+    output?: string;
+    format?: string;
+}
+export declare function handoverCommand(options: HandoverOptions): Promise<void>;
+//# sourceMappingURL=handover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handover.d.ts","sourceRoot":"","sources":["../../src/commands/handover.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B7E"}

package/dist/commands/handover.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * handover - 生成交接文档命令
+ * 汇总期次关键信息、待办事项和风险点
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handoverCommand = handoverCommand;
+const logger_1 = require("../utils/logger");
+const context_1 = require("../core/context");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+async function handoverCommand(options) {
+    const spinner = new logger_1.Spinner('正在生成交接文档...');
+    spinner.start();
+    try {
+        const iteration = await (0, context_1.getDefaultIteration)(options.iteration);
+        if (!iteration) {
+            spinner.fail('未找到活跃期次。请先运行: speccore iteration create --name <名称>');
+            return;
+        }
+        const doc = await generateHandoverDoc(iteration);
+        const format = options.format || 'md';
+        const outputPath = options.output || (0, path_1.join)(process.cwd(), iteration, '00-期次总览', `交接文档.${format}`);
+        await (0, fs_extra_1.writeFile)(outputPath, doc);
+        spinner.stop(`交接文档已生成: ${outputPath}`);
+        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('   - 风险与建议');
+    }
+    catch (error) {
+        spinner.fail(`交接文档生成失败: ${error}`);
+        throw error;
+    }
+}
+async function generateHandoverDoc(iteration) {
+    const iterDir = (0, path_1.join)(process.cwd(), iteration);
+    const now = new Date().toISOString().split('T')[0];
+    // 扫描任务
+    const tasks = await scanTasks(iterDir);
+    const completed = tasks.filter((t) => t.status === 'completed');
+    const inProgress = tasks.filter((t) => t.status === 'in_progress');
+    const pending = tasks.filter((t) => t.status === 'pending');
+    let doc = `# ${iteration} - 交接文档\n\n`;
+    doc += `> 生成日期: ${now} | 生成工具: SpecCore\n\n`;
+    doc += `---\n\n`;
+    // 1. 期次概览
+    doc += `## 1. 期次概览\n\n`;
+    doc += `| 指标 | 数值 |\n`;
+    doc += `| :--- | :--- |\n`;
+    doc += `| 期次名称 | ${iteration} |\n`;
+    doc += `| 总任务数 | ${tasks.length} |\n`;
+    doc += `| 已完成 | ${completed.length} |\n`;
+    doc += `| 进行中 | ${inProgress.length} |\n`;
+    doc += `| 待开发 | ${pending.length} |\n`;
+    doc += `| 完成率 | ${tasks.length > 0 ? Math.round((completed.length / tasks.length) * 100) : 0}% |\n\n`;
+    // 2. 任务详情
+    doc += `## 2. 任务详情\n\n`;
+    if (completed.length > 0) {
+        doc += `### ✅ 已完成任务\n\n`;
+        doc += `| 任务 | 类型 | 完成日期 |\n`;
+        doc += `| :--- | :--- | :--- |\n`;
+        for (const t of completed) {
+            doc += `| ${t.id} - ${t.name} | ${t.type} | ${t.endDate || '-'} |\n`;
+        }
+        doc += `\n`;
+    }
+    if (inProgress.length > 0) {
+        doc += `### 🟦 进行中任务\n\n`;
+        doc += `| 任务 | 类型 | 进度 | 阻塞项 |\n`;
+        doc += `| :--- | :--- | :--- | :--- |\n`;
+        for (const t of inProgress) {
+            doc += `| ${t.id} - ${t.name} | ${t.type} | ${t.progress}% | ${t.blockers.join(', ') || '-'} |\n`;
+        }
+        doc += `\n`;
+    }
+    if (pending.length > 0) {
+        doc += `### 🔲 待开发任务\n\n`;
+        doc += `| 任务 | 类型 | 优先级 |\n`;
+        doc += `| :--- | :--- | :--- |\n`;
+        for (const t of pending) {
+            doc += `| ${t.id} - ${t.name} | ${t.type} | ${t.priority || '-'} |\n`;
+        }
+        doc += `\n`;
+    }
+    // 3. 关键决策
+    doc += `## 3. 关键决策记录\n\n`;
+    // 从 ARCHITECTURE.md 提取
+    const archPath = (0, path_1.join)(iterDir, '00-技术文档', 'ARCHITECTURE.md');
+    if (await (0, fs_extra_1.pathExists)(archPath)) {
+        const content = await (0, fs_extra_1.readFile)(archPath, 'utf-8');
+        const decisions = content.match(/##\s*决策[\s\S]*?(?=\n##|\n---|$)/);
+        if (decisions) {
+            doc += decisions[0].trim() + '\n\n';
+        }
+        else {
+            doc += '（无记录）\n\n';
+        }
+    }
+    else {
+        doc += '（无 ARCHITECTURE.md）\n\n';
+    }
+    // 4. 待办事项
+    doc += `## 4. 待办事项\n\n`;
+    doc += `- [ ] 审查未完成任务的 Spec 文件\n`;
+    doc += `- [ ] 确认所有接口契约已更新\n`;
+    doc += `- [ ] 回归测试已完成任务的功能\n\n`;
+    // 5. 风险与建议
+    doc += `## 5. 风险与建议\n\n`;
+    doc += `| 风险项 | 级别 | 建议 |\n`;
+    doc += `| :--- | :--- | :--- |\n`;
+    if (inProgress.length > 0) {
+        doc += `| 有 ${inProgress.length} 个任务仍在进行中 | 中 | 建议在交接前推动完成或重新分配 |\n`;
+    }
+    if (pending.length > 3) {
+        doc += `| 待开发任务较多（${pending.length} 个） | 中 | 建议评估优先级，适当延期部分任务 |\n`;
+    }
+    doc += `| | | |\n\n`;
+    // 6. 附录
+    doc += `## 6. 附录\n\n`;
+    doc += `### 相关文件\n\n`;
+    doc += `- 期次目录: \`${iteration}/\`\n`;
+    doc += `- 技术架构: \`${iteration}/00-技术文档/ARCHITECTURE.md\`\n`;
+    doc += `- 需求文档: \`${iteration}/00-需求文档/REQUIREMENT.md\`\n`;
+    doc += `- 项目图谱: \`${iteration}/00-期次总览/PROJECT_GRAPH.md\`\n`;
+    return doc;
+}
+async function scanTasks(iterDir) {
+    const tasks = [];
+    if (!await (0, fs_extra_1.pathExists)(iterDir))
+        return tasks;
+    const entries = await (0, fs_extra_1.readdir)(iterDir);
+    const taskDirs = entries.filter((e) => e.startsWith('Task-'));
+    for (const taskDir of taskDirs) {
+        const taskInfo = {
+            id: taskDir,
+            name: taskDir,
+            type: 'feature',
+            status: 'pending',
+            progress: 0,
+            blockers: [],
+        };
+        // 读取 .task-type
+        const typePath = (0, path_1.join)(iterDir, taskDir, '.task-type');
+        if (await (0, fs_extra_1.pathExists)(typePath)) {
+            taskInfo.type = (await (0, fs_extra_1.readFile)(typePath, 'utf-8')).trim();
+        }
+        // 读取 TASK.md 获取状态
+        const taskMdPath = (0, path_1.join)(iterDir, taskDir, 'backend', 'TASK.md');
+        if (await (0, fs_extra_1.pathExists)(taskMdPath)) {
+            const content = await (0, fs_extra_1.readFile)(taskMdPath, 'utf-8');
+            if (content.includes('✅ 已完成'))
+                taskInfo.status = 'completed';
+            else if (content.includes('🟦 开发中') || content.includes('进行中'))
+                taskInfo.status = 'in_progress';
+            // 提取任务名称
+            const nameMatch = content.match(/^#\s*(.+?)(?:\s*-\s*执行追踪)?$/m);
+            if (nameMatch) {
+                taskInfo.name = nameMatch[1].trim();
+            }
+        }
+        tasks.push(taskInfo);
+    }
+    return tasks;
+}
+//# sourceMappingURL=handover.js.map

package/dist/commands/handover.js.map

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

package/dist/commands/help.d.ts

@@ -0,0 +1,10 @@
+/**
+ * help - 命令帮助命令
+ * 显示所有可用命令、别名和参数说明
+ */
+export interface HelpOptions {
+    command?: string;
+    search?: string;
+}
+export declare function helpCommand(options: HelpOptions): Promise<void>;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAYrE"}

package/dist/commands/help.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * help - 命令帮助命令
+ * 显示所有可用命令、别名和参数说明
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.helpCommand = helpCommand;
+const logger_1 = require("../utils/logger");
+const intent_recognition_1 = require("../core/intent-recognition");
+async function helpCommand(options) {
+    if (options.command) {
+        await showCommandDetail(options.command);
+        return;
+    }
+    if (options.search) {
+        await searchCommands(options.search);
+        return;
+    }
+    showAllCommands();
+}
+function showAllCommands() {
+    logger_1.logger.info('📖 SpecCore 命令帮助');
+    logger_1.logger.info('');
+    // 分类显示
+    const categories = {
+        '🔍 智能入口': ['spec - 自然语言意图识别，自动匹配命令'],
+        '👋 引导与体验': ['welcome - 首次使用引导', 'demo - 快速体验示例项目'],
+        '🏗️ 初始化与导入': ['init - 初始化 SpecCore 项目', 'import - 从存量项目导入'],
+        '📋 期次管理': ['iteration create - 创建期次', 'iteration split - 需求拆分为任务'],
+        '📝 任务管理': ['task new - 创建任务', 'goal - 完整需求交付', 'bugfix - 快速 Bug 修复', 'research - 技术调研'],
+        '⚡ 执行与调度': ['plan - 智能调度方案', 'execute - 执行控制中心'],
+        '🔄 变更管理': ['change - 需求变更联动', 'sync - 反向同步（代码→Spec）'],
+        '✅ 审查与验证': ['review - 审查产出', 'validate - Spec 合规性检查'],
+        '📊 进度与状态': ['progress - 进度总览', 'status - 状态看板', 'health - 项目健康度'],
+        '📦 归档与交接': ['archive - 归档任务', 'handover - 生成交接文档', 'retro - 期次回顾'],
+        '⚙️ 配置与工具': ['config - 配置管理', 'report - 生成项目报告', 'template-add - 添加代码模板'],
+    };
+    for (const [category, commands] of Object.entries(categories)) {
+        logger_1.logger.info('');
+        logger_1.logger.info(`${category}:`);
+        for (const cmd of commands) {
+            logger_1.logger.info(`  speccore ${cmd}`);
+        }
+    }
+    logger_1.logger.info('');
+    logger_1.logger.info('---');
+    logger_1.logger.info('💡 使用 speccore help --command=<命令名> 查看详细参数');
+    logger_1.logger.info('💡 使用 speccore help --search=<关键词> 搜索相关命令');
+}
+async function showCommandDetail(commandName) {
+    const mapping = (0, intent_recognition_1.getCommandMapping)(commandName);
+    if (!mapping) {
+        // 尝试在现有命令中查找
+        logger_1.logger.warn(`未找到命令 "${commandName}"。`);
+        logger_1.logger.info('可用的命令:');
+        const all = (0, intent_recognition_1.getAllCommandMappings)();
+        for (const m of all) {
+            logger_1.logger.info(`  - speccore ${m.id}: ${m.description}`);
+        }
+        return;
+    }
+    logger_1.logger.info(`📖 speccore ${mapping.id}`);
+    logger_1.logger.info('');
+    logger_1.logger.info(`描述: ${mapping.description}`);
+    logger_1.logger.info(`优先级: ${mapping.priority}`);
+    logger_1.logger.info('');
+    logger_1.logger.info('触发关键词:');
+    logger_1.logger.info(`  ${mapping.triggers.join(' / ')}`);
+    logger_1.logger.info('');
+    if (mapping.args) {
+        logger_1.logger.info(`参数: ${mapping.args}`);
+    }
+    logger_1.logger.info('更多参数请使用 --help 查看。');
+}
+async function searchCommands(keyword) {
+    const all = (0, intent_recognition_1.getAllCommandMappings)();
+    const matched = all.filter((m) => m.id.includes(keyword) ||
+        m.description.includes(keyword) ||
+        m.triggers.some((t) => t.includes(keyword)));
+    if (matched.length === 0) {
+        logger_1.logger.warn(`未找到匹配 "${keyword}" 的命令。`);
+        return;
+    }
+    logger_1.logger.info(`🔍 搜索 "${keyword}" 的结果:`);
+    logger_1.logger.info('');
+    for (const m of matched) {
+        logger_1.logger.info(`  speccore ${m.id}`);
+        logger_1.logger.info(`    ${m.description}`);
+        logger_1.logger.info(`    触发: ${m.triggers.slice(0, 3).join(', ')}`);
+        logger_1.logger.info('');
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

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

package/dist/commands/history.d.ts

@@ -0,0 +1,9 @@
+/**
+ * history - 查看需求变更历史命令
+ * 输出指定需求（REQ-XXX）的完整变更历史，包括来源、版本演进、关联期次
+ */
+export interface HistoryOptions {
+    req?: string;
+}
+export declare function historyCommand(options: HistoryOptions): Promise<void>;
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsF3E"}

package/dist/commands/history.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * history - 查看需求变更历史命令
+ * 输出指定需求（REQ-XXX）的完整变更历史，包括来源、版本演进、关联期次
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.historyCommand = historyCommand;
+const logger_1 = require("../utils/logger");
+const global_layer_1 = require("../core/global-layer");
+async function historyCommand(options) {
+    if (!options.req) {
+        logger_1.logger.error('请提供需求 ID。用法: speccore history --req=<REQ-XXX>');
+        logger_1.logger.info('提示: 使用 speccore global-status 查看可用需求列表');
+        return;
+    }
+    const spinner = new logger_1.Spinner('查询需求历史...');
+    spinner.start();
+    try {
+        // 1. 定位需求
+        const index = await (0, global_layer_1.readGlobalIndex)();
+        const reqEntry = index.reqs.find((r) => r.id === options.req);
+        if (!reqEntry) {
+            spinner.fail(`需求 ${options.req} 不存在`);
+            logger_1.logger.info('');
+            logger_1.logger.info('在 GLOBAL/INDEX.md 中未找到该需求 ID。');
+            logger_1.logger.info('请运行 speccore global-status 查看可用需求列表。');
+            return;
+        }
+        // 2. 读取需求详情（含变更历史）
+        const detail = await (0, global_layer_1.readRequirementDetail)(reqEntry.project, options.req);
+        spinner.stop();
+        // 3. 输出报告
+        logger_1.logger.info('');
+        logger_1.logger.info(`📜 需求历史: ${options.req} ${reqEntry.name}`);
+        logger_1.logger.info('');
+        // 来源信息
+        logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        logger_1.logger.info('📋 当前状态');
+        logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        logger_1.logger.info(`   当前版本: ${reqEntry.version}`);
+        logger_1.logger.info(`   状态: ${reqEntry.status}`);
+        logger_1.logger.info(`   来源项目: ${reqEntry.project}`);
+        logger_1.logger.info(`   关联期次: ${reqEntry.iteration || '-'}`);
+        logger_1.logger.info(`   关联 Task: ${reqEntry.task || '-'}`);
+        logger_1.logger.info(`   文件位置: ${reqEntry.filePath}`);
+        // 变更历史（从详情中提取）
+        if (detail) {
+            logger_1.logger.info('');
+            logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            logger_1.logger.info('📝 变更历史');
+            logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            const changelogMatch = detail.match(/📝 变更历史[^]*$/m);
+            if (changelogMatch) {
+                const lines = changelogMatch[0].split('\n');
+                for (const line of lines) {
+                    if (line.trim()) {
+                        logger_1.logger.info(`   ${line.trim()}`);
+                    }
+                }
+            }
+            else {
+                logger_1.logger.info('   （无变更历史）');
+            }
+        }
+        // 元数据
+        if (detail) {
+            logger_1.logger.info('');
+            logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            logger_1.logger.info('📦 元数据');
+            logger_1.logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            const metaLines = detail.split('\n').filter((l) => l.includes('|') && l.includes(':---'));
+            for (let i = 0; i < detail.split('\n').length; i++) {
+                const line = detail.split('\n')[i];
+                if (line.includes('来源') || line.includes('当前版本') || line.includes('状态') || line.includes('最后修改')) {
+                    logger_1.logger.info(`   ${line.trim()}`);
+                }
+            }
+        }
+        logger_1.logger.info('');
+        logger_1.logger.info('💡 提示: 要查看完整的代码级变更记录，请使用 git log 查看对应文件。');
+    }
+    catch (error) {
+        spinner.fail(`查询历史失败: ${error}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=history.js.map