speccore 5.3.2 → 5.3.4

package/dist/commands/rename.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * rename - 重命名期次或任务，自动更新所有关联引用
+ * 支持单个重命名和批量重命名
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renameCommand = renameCommand;
+const logger_1 = require("../utils/logger");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const global_layer_1 = require("../core/global-layer");
+async function renameCommand(options) {
+    try {
+        if (options.batch) {
+            await batchRename(options);
+        }
+        else if (options.target && options.newName) {
+            await singleRename(options);
+        }
+        else {
+            logger_1.logger.error('用法:');
+            logger_1.logger.info('  单个重命名: speccore rename --target=<旧名> --new-name=<新名>');
+            logger_1.logger.info('  批量重命名: speccore rename --batch --pattern=<旧前缀> --replacement=<新前缀>');
+        }
+    }
+    catch (error) {
+        logger_1.logger.error(`重命名失败: ${error}`);
+        throw error;
+    }
+}
+/**
+ * 单个重命名
+ */
+async function singleRename(options) {
+    const oldName = options.target;
+    const newName = options.newName;
+    const cwd = process.cwd();
+    // 1. 识别目标类型
+    let targetType;
+    const isIteration = oldName.includes('期次-');
+    const isTask = oldName.match(/Task-\d{3}/);
+    if (isIteration) {
+        targetType = 'iteration';
+    }
+    else if (isTask) {
+        targetType = 'task';
+    }
+    else {
+        logger_1.logger.error(`无法识别目标类型: "${oldName}"。名称需包含"期次-"或"Task-NNN"。`);
+        return;
+    }
+    // 2. 验证目标存在
+    const spinner = new logger_1.Spinner('验证目标...');
+    spinner.start();
+    let oldPath;
+    if (targetType === 'iteration') {
+        oldPath = (0, path_1.join)(cwd, oldName);
+    }
+    else {
+        // Task 需要先找到归属期次
+        const iterations = await findIterations(cwd);
+        let found = false;
+        oldPath = '';
+        for (const iter of iterations) {
+            const taskPath = (0, path_1.join)(cwd, iter, oldName);
+            if (await (0, fs_extra_1.pathExists)(taskPath)) {
+                oldPath = taskPath;
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            spinner.fail(`未找到 Task: ${oldName}`);
+            logger_1.logger.info('请确认 Task 编号和名称正确。');
+            return;
+        }
+    }
+    if (!(await (0, fs_extra_1.pathExists)(oldPath))) {
+        spinner.fail(`目标不存在: ${oldName}`);
+        return;
+    }
+    // 3. 计算影响范围
+    spinner.stop('计算影响范围...');
+    const preview = await calculatePreview(targetType, oldName, newName, oldPath);
+    await showPreview(preview);
+    if (!options.force) {
+        logger_1.logger.info('');
+        logger_1.logger.info('使用 --force 跳过预览并直接执行。');
+        return;
+    }
+    // 4. 执行重命名
+    await executeRename(preview);
+    // 5. 更新全量索引
+    await updateGlobalReferences(oldName, newName, targetType);
+}
+/**
+ * 批量重命名
+ */
+async function batchRename(options) {
+    const pattern = options.pattern;
+    const replacement = options.replacement;
+    if (!pattern || !replacement) {
+        logger_1.logger.error('批量重命名需要 --pattern 和 --replacement 参数。');
+        return;
+    }
+    const cwd = process.cwd();
+    const iterations = await findIterations(cwd);
+    let totalCount = 0;
+    const previews = [];
+    for (const iter of iterations) {
+        const iterPath = (0, path_1.join)(cwd, iter);
+        if (!(await (0, fs_extra_1.pathExists)(iterPath)))
+            continue;
+        const entries = await (0, fs_extra_1.readdir)(iterPath, { withFileTypes: true });
+        for (const entry of entries.filter((e) => e.isDirectory())) {
+            if (entry.name.match(/Task-\d{3}.*/)) {
+                const newTaskName = entry.name.replace(pattern, replacement);
+                if (newTaskName !== entry.name) {
+                    const preview = await calculatePreview('task', entry.name, newTaskName, (0, path_1.join)(iterPath, entry.name));
+                    previews.push(preview);
+                    totalCount++;
+                }
+            }
+        }
+    }
+    if (totalCount === 0) {
+        logger_1.logger.info('没有找到匹配的目标。');
+        return;
+    }
+    logger_1.logger.info('');
+    logger_1.logger.info('📋 批量重命名预览');
+    logger_1.logger.info('');
+    logger_1.logger.info(`操作: 将 "${pattern}" 替换为 "${replacement}"`);
+    logger_1.logger.info(`影响任务数: ${totalCount}`);
+    logger_1.logger.info('');
+    for (const p of previews.slice(0, 10)) {
+        logger_1.logger.info(`   ${p.oldName} → ${p.newName}`);
+    }
+    if (previews.length > 10) {
+        logger_1.logger.info(`   ...（共 ${previews.length} 个）`);
+    }
+    if (!options.force) {
+        logger_1.logger.info('');
+        logger_1.logger.info('⚠️ 批量重命名是高风险操作。使用 --force 执行。');
+        return;
+    }
+    // 执行批量重命名
+    for (const p of previews) {
+        try {
+            await executeRename(p);
+            logger_1.logger.info(`   ✅ ${p.oldName} → ${p.newName}`);
+        }
+        catch (e) {
+            logger_1.logger.error(`   ❌ ${p.oldName}: ${e}`);
+        }
+    }
+    logger_1.logger.info('');
+    logger_1.logger.success(`✅ 批量重命名完成！共 ${totalCount} 个任务`);
+}
+/**
+ * 计算影响范围预览
+ */
+async function calculatePreview(type, oldName, newName, oldPath) {
+    let newPath = oldPath.replace(oldName, newName);
+    let indexUpdates = 0;
+    let specRefs = 0;
+    const files = [];
+    // 全局索引更新
+    const index = await (0, global_layer_1.readGlobalIndex)();
+    if (type === 'iteration') {
+        indexUpdates += index.reqs.filter((r) => r.iteration === oldName).length;
+        indexUpdates += index.iterations.filter((i) => i.name === oldName).length;
+    }
+    else {
+        indexUpdates += index.reqs.filter((r) => r.task === oldName).length;
+    }
+    // Spec 文件引用数量估算
+    const iterations = await (async () => {
+        try {
+            return await findIterations(process.cwd());
+        }
+        catch {
+            return [];
+        }
+    })();
+    for (const iter of iterations) {
+        const graphPath = (0, path_1.join)(process.cwd(), iter, '00-期次总览', 'PROJECT_GRAPH.md');
+        if (await (0, fs_extra_1.pathExists)(graphPath)) {
+            const gContent = await (0, fs_extra_1.readFile)(graphPath, 'utf-8');
+            const matches = gContent.split(oldName).length - 1;
+            specRefs += matches;
+            if (matches > 0)
+                files.push(graphPath);
+        }
+    }
+    // 索引文件
+    const indexPath = (0, path_1.join)(process.cwd(), '.speccore', 'GLOBAL', 'INDEX.md');
+    if (await (0, fs_extra_1.pathExists)(indexPath)) {
+        files.push(indexPath);
+    }
+    const iterIndexPath = (0, path_1.join)(process.cwd(), '.speccore', 'ITERATIONS', 'README.md');
+    if (await (0, fs_extra_1.pathExists)(iterIndexPath)) {
+        files.push(iterIndexPath);
+    }
+    return {
+        type,
+        oldName,
+        newName,
+        dirRename: `${oldPath} → ${newPath}`,
+        indexUpdates,
+        specRefs,
+        files: [...new Set(files)],
+    };
+}
+/**
+ * 显示预览
+ */
+async function showPreview(preview) {
+    logger_1.logger.info('');
+    logger_1.logger.info('📋 重命名预览');
+    logger_1.logger.info('');
+    logger_1.logger.info(`目标类型: ${preview.type === 'iteration' ? '期次' : '任务'}`);
+    logger_1.logger.info(`旧名称: ${preview.oldName}`);
+    logger_1.logger.info(`新名称: ${preview.newName}`);
+    logger_1.logger.info('');
+    logger_1.logger.info('影响范围:');
+    logger_1.logger.info(`   目录重命名: 1 处`);
+    logger_1.logger.info(`   索引更新: ${preview.indexUpdates} 处`);
+    logger_1.logger.info(`   Spec 引用更新: ~${preview.specRefs} 处`);
+    logger_1.logger.info(`   涉及文件: ${preview.files.length} 个`);
+}
+/**
+ * 执行重命名
+ */
+async function executeRename(preview) {
+    const cwd = process.cwd();
+    // 1. 目录重命名
+    let oldPath;
+    if (preview.type === 'iteration') {
+        oldPath = (0, path_1.join)(cwd, preview.oldName);
+    }
+    else {
+        const iterations = await findIterations(cwd);
+        oldPath = '';
+        for (const iter of iterations) {
+            const p = (0, path_1.join)(cwd, iter, preview.oldName);
+            if (await (0, fs_extra_1.pathExists)(p)) {
+                oldPath = p;
+                break;
+            }
+        }
+    }
+    if (oldPath && await (0, fs_extra_1.pathExists)(oldPath)) {
+        const newPath = oldPath.replace(preview.oldName, preview.newName);
+        await (0, fs_extra_1.move)(oldPath, newPath, { overwrite: true });
+    }
+    // 2. 更新所有引用文件
+    for (const file of preview.files) {
+        if (await (0, fs_extra_1.pathExists)(file)) {
+            let content = await (0, fs_extra_1.readFile)(file, 'utf-8');
+            if (content.includes(preview.oldName)) {
+                content = content.split(preview.oldName).join(preview.newName);
+                await (0, fs_extra_1.writeFile)(file, content);
+            }
+        }
+    }
+}
+/**
+ * 更新全量索引引用
+ */
+async function updateGlobalReferences(oldName, newName, type) {
+    const index = await (0, global_layer_1.readGlobalIndex)();
+    for (const req of index.reqs) {
+        if (type === 'iteration' && req.iteration === oldName) {
+            await (0, global_layer_1.updateReqInIndex)(req.id, { iteration: newName });
+        }
+        else if (type === 'task' && req.task === oldName) {
+            await (0, global_layer_1.updateReqInIndex)(req.id, { task: newName });
+        }
+    }
+    const newVersion = (0, global_layer_1.bumpGlobalVersion)(index.version);
+    await (0, global_layer_1.updateIndexVersion)(newVersion);
+    logger_1.logger.info('');
+    logger_1.logger.success('✅ 重命名完成！');
+    logger_1.logger.info('');
+    logger_1.logger.info(`   ${oldName} → ${newName}`);
+    logger_1.logger.info('   全量层版本: ' + newVersion);
+}
+/**
+ * 查找所有期次目录
+ */
+async function findIterations(cwd) {
+    const entries = await (0, fs_extra_1.readdir)(cwd, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isDirectory() && e.name.startsWith('期次-'))
+        .map((e) => e.name);
+}
+//# sourceMappingURL=rename.js.map

package/dist/commands/rename.js.map

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

package/dist/commands/research.d.ts

@@ -0,0 +1,14 @@
+/**
+ * research - 技术调研命令
+ * 创建技术调研任务，评估技术方案、对比工具选项
+ */
+export interface ResearchOptions {
+    name?: string;
+    desc?: string;
+    topic?: string;
+    options?: string;
+    taskId?: string;
+    iteration?: string;
+}
+export declare function researchCommand(options: ResearchOptions): Promise<void>;
+//# sourceMappingURL=research.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/commands/research.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D7E"}

package/dist/commands/research.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * research - 技术调研命令
+ * 创建技术调研任务，评估技术方案、对比工具选项
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.researchCommand = researchCommand;
+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 researchCommand(options) {
+    if (!options.name && !options.topic) {
+        logger_1.logger.error('请提供调研主题。用法: speccore research --name "<主题>" [--options "选项A,选项B"]');
+        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 topic = options.name || options.topic || '技术调研';
+        const taskId = options.taskId || await generateTaskId(iteration);
+        const compareOptions = options.options
+            ? options.options.split(',').map((o) => o.trim())
+            : [];
+        // 创建调研任务目录
+        const taskDir = (0, path_1.join)(iteration, taskId);
+        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend'));
+        // 创建 .task-type
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.task-type'), 'research');
+        // 生成调研 Spec
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'REQ.md'), generateResearchReq(topic, options.desc || '', compareOptions));
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'TASK.md'), generateResearchTask(topic, options.desc || ''));
+        spinner.stop(`技术调研任务已创建: ${taskId}`);
+        logger_1.logger.info('');
+        logger_1.logger.info(`🔬 调研详情:`);
+        logger_1.logger.info(`   期次: ${iteration}`);
+        logger_1.logger.info(`   任务: ${taskId} - ${topic}`);
+        if (compareOptions.length > 0) {
+            logger_1.logger.info(`   对比选项: ${compareOptions.join(', ')}`);
+        }
+        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. 运行: speccore execute --task=${taskId}`);
+    }
+    catch (error) {
+        spinner.fail(`调研任务创建失败: ${error}`);
+        throw error;
+    }
+}
+async function generateTaskId(iteration) {
+    let maxId = 0;
+    const iterationDir = (0, path_1.join)(process.cwd(), iteration);
+    if (await (0, fs_extra_1.pathExists)(iterationDir)) {
+        const { readdir } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+        const entries = await readdir(iterationDir);
+        for (const entry of entries) {
+            const match = entry.match(/^Task-(\d+)$/);
+            if (match) {
+                const id = parseInt(match[1], 10);
+                if (id > maxId)
+                    maxId = id;
+            }
+        }
+    }
+    return `Task-${String(maxId + 1).padStart(3, '0')}`;
+}
+function generateResearchReq(topic, desc, options) {
+    let optionsSection = '';
+    if (options.length > 0) {
+        optionsSection = '\n## 3. 候选方案\n\n';
+        for (const opt of options) {
+            optionsSection += `### ${opt}\n\n- 优势：\n- 劣势：\n- 适用场景：\n\n`;
+        }
+    }
+    return `# ${topic} - 技术调研需求
+
+## 1. 调研背景
+
+${desc || '请补充调研背景'}
+
+## 2. 调研目标
+
+- 
+- 
+${optionsSection}
+## ${options.length > 0 ? '4' : '3'}. 评估维度
+
+| 维度 | 权重 | 说明 |
+| :--- | :--- | :--- |
+| 性能 | 30% | |
+| 易用性 | 25% | |
+| 生态/社区 | 20% | |
+| 维护成本 | 15% | |
+| 团队熟悉度 | 10% | |
+
+## ${options.length > 0 ? '5' : '4'}. 决策标准
+
+- 
+- 
+
+## ${options.length > 0 ? '6' : '5'}. 产出物
+
+- [ ] 技术调研报告
+- [ ] Demo 代码（如适用）
+- [ ] 推荐方案及理由
+`;
+}
+function generateResearchTask(topic, desc) {
+    const now = new Date().toISOString().split('T')[0];
+    return `# ${topic} - 执行追踪
+
+> **任务类型**: research | **创建日期**: ${now} | **状态**: 🔲 待开发
+
+## 1. 变更履历
+
+| 日期 | 版本 | 变更说明 | 作者 |
+| :--- | :--- | :--- | :--- |
+| ${now} | v1.0 | 初始创建：${desc || topic} | SpecCore |
+
+## 2. 调研步骤
+
+- [ ] 信息收集
+- [ ] 对比分析
+- [ ] Demo 验证
+- [ ] 撰写报告
+- [ ] 团队评审
+
+## 3. 参考资源
+
+| 资源 | 链接 | 备注 |
+| :--- | :--- | :--- |
+| | | |
+
+## 4. 结论与建议
+
+（调研完成后填写）
+`;
+}
+//# sourceMappingURL=research.js.map

package/dist/commands/research.js.map

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

package/dist/commands/retro.d.ts

@@ -0,0 +1,10 @@
+/**
+ * retro - 期次回顾命令
+ * 总结期次经验和改进建议
+ */
+export interface RetroOptions {
+    iteration?: string;
+    output?: string;
+}
+export declare function retroCommand(options: RetroOptions): Promise<void>;
+//# sourceMappingURL=retro.d.ts.map

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

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

package/dist/commands/retro.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * retro - 期次回顾命令
+ * 总结期次经验和改进建议
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retroCommand = retroCommand;
+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 retroCommand(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 generateRetroDoc(iteration);
+        const outputPath = options.output || (0, path_1.join)(process.cwd(), iteration, '00-期次总览', '回顾总结.md');
+        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('   - 做得好的 (Went Well)');
+        logger_1.logger.info('   - 待改进的 (To Improve)');
+        logger_1.logger.info('   - 行动计划 (Action Items)');
+    }
+    catch (error) {
+        spinner.fail(`期次回顾生成失败: ${error}`);
+        throw error;
+    }
+}
+async function generateRetroDoc(iteration) {
+    const iterDir = (0, path_1.join)(process.cwd(), iteration);
+    const now = new Date().toISOString().split('T')[0];
+    // 收集统计数据
+    const stats = await collectStats(iterDir, iteration);
+    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 += `| 总任务数 | ${stats.totalTasks} |\n`;
+    doc += `| 完成任务数 | ${stats.completedTasks} |\n`;
+    doc += `| 完成率 | ${stats.completionRate}% |\n`;
+    doc += `| 任务类型分布 | ${stats.typeDistribution} |\n\n`;
+    // 2. 做得好的
+    doc += `## 2. 做得好的 👍\n\n`;
+    doc += `| 方面 | 具体表现 | 可复用经验 |\n`;
+    doc += `| :--- | :--- | :--- |\n`;
+    doc += `| | | |\n`;
+    doc += `| | | |\n`;
+    doc += `| | | |\n\n`;
+    // 3. 待改进的
+    doc += `## 3. 待改进的 🔧\n\n`;
+    doc += `| 方面 | 问题描述 | 影响 | 改进建议 |\n`;
+    doc += `| :--- | :--- | :--- | :--- |\n`;
+    doc += `| | | | |\n`;
+    doc += `| | | | |\n`;
+    doc += `| | | | |\n\n`;
+    // 4. 行动计划
+    doc += `## 4. 行动计划 📋\n\n`;
+    doc += `| 行动项 | 负责人 | 截止日期 | 优先级 |\n`;
+    doc += `| :--- | :--- | :--- | :--- |\n`;
+    if (stats.completionRate < 100) {
+        doc += `| 完成剩余 ${stats.totalTasks - stats.completedTasks} 个任务 | 待分配 | | 高 |\n`;
+    }
+    doc += `| 更新项目 PATTERNS 模式库 | | | 中 |\n`;
+    doc += `| 整理技术文档 | | | 中 |\n`;
+    doc += `| | | | |\n\n`;
+    // 5. 下期展望
+    doc += `## 5. 下期展望\n\n`;
+    const archPath = (0, path_1.join)(iterDir, '00-需求文档', 'REQUIREMENT.md');
+    if (await (0, fs_extra_1.pathExists)(archPath)) {
+        const content = await (0, fs_extra_1.readFile)(archPath, 'utf-8');
+        const nextMatch = content.match(/下期|后续|下一期/);
+        if (nextMatch) {
+            doc += '请参考需求文档中的下期规划。\n\n';
+        }
+        else {
+            doc += '（请在需求文档中补充下期规划）\n\n';
+        }
+    }
+    else {
+        doc += '（请创建需求文档）\n\n';
+    }
+    return doc;
+}
+async function collectStats(iterDir, _iteration) {
+    let totalTasks = 0;
+    let completedTasks = 0;
+    const types = {};
+    if (await (0, fs_extra_1.pathExists)(iterDir)) {
+        const entries = await (0, fs_extra_1.readdir)(iterDir);
+        const taskDirs = entries.filter((e) => e.startsWith('Task-'));
+        for (const taskDir of taskDirs) {
+            totalTasks++;
+            const typePath = (0, path_1.join)(iterDir, taskDir, '.task-type');
+            if (await (0, fs_extra_1.pathExists)(typePath)) {
+                const type = (await (0, fs_extra_1.readFile)(typePath, 'utf-8')).trim();
+                types[type] = (types[type] || 0) + 1;
+            }
+            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('✅ 已完成')) {
+                    completedTasks++;
+                }
+            }
+        }
+    }
+    const completionRate = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+    const typeDist = Object.entries(types)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join(', ');
+    return {
+        totalTasks,
+        completedTasks,
+        completionRate,
+        typeDistribution: typeDist || '-',
+    };
+}
+//# sourceMappingURL=retro.js.map