speccore 1.0.0

package/dist/commands/global-status.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * global-status - 查看全量层状态命令
+ * 基于 GLOBAL/INDEX.md 展示所有项目、需求、技术架构的状态
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalStatusCommand = globalStatusCommand;
+const logger_1 = require("../utils/logger");
+const global_layer_1 = require("../core/global-layer");
+async function globalStatusCommand(options) {
+    const spinner = new logger_1.Spinner('读取全量层数据...');
+    spinner.start();
+    try {
+        const index = await (0, global_layer_1.readGlobalIndex)();
+        spinner.stop();
+        // 空状态检查
+        if (index.projects.length === 0) {
+            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('   speccore import --project=XXX --path=./XXX --type=backend');
+            return;
+        }
+        if (options.project) {
+            await showProjectDetail(options.project, index);
+        }
+        else {
+            await showGlobalOverview(index);
+        }
+    }
+    catch (error) {
+        spinner.fail(`读取全量层失败: ${error}`);
+        throw error;
+    }
+}
+/**
+ * 全量总览
+ */
+async function showGlobalOverview(index) {
+    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('├──────────────┼──────────┼────────┼────────┼──────┼──────┼────┤');
+    for (const proj of index.projects) {
+        const hasExisting = proj.type === 'backend' ? 0 : 0;
+        const implemented = proj.implemented || 0;
+        const inProgress = proj.inProgress || 0;
+        const pending = proj.pending || 0;
+        const existing = hasExisting || 0;
+        logger_1.logger.info(`│ ${pad(proj.name, 12)} │ ${pad(proj.type, 8)} │ ${pad(String(proj.reqCount), 6)} │ ${pad(String(implemented), 6)} │ ${pad(String(inProgress), 4)} │ ${pad(String(pending), 4)} │ ${pad(String(existing), 2)} │`);
+    }
+    // 合计行
+    const totalReqs = index.projects.reduce((s, p) => s + p.reqCount, 0);
+    const totalDone = index.projects.reduce((s, p) => s + (p.implemented || 0), 0);
+    const totalProgress = index.projects.reduce((s, p) => s + (p.inProgress || 0), 0);
+    const totalPending = index.projects.reduce((s, p) => s + (p.pending || 0), 0);
+    logger_1.logger.info('├──────────────┼──────────┼────────┼────────┼──────┼──────┼────┤');
+    logger_1.logger.info(`│ 合计         │ ${index.projects.length} 个项目 │ ${pad(String(totalReqs), 6)} │ ${pad(String(totalDone), 6)} │ ${pad(String(totalProgress), 4)} │ ${pad(String(totalPending), 4)} │ 0  │`);
+    logger_1.logger.info('└──────────────┴──────────┴────────┴────────┴──────┴──────┴────┘');
+    // 需求总览
+    logger_1.logger.info('');
+    logger_1.logger.info('📋 需求总览:');
+    if (index.reqs.length === 0) {
+        logger_1.logger.info('   暂无需求');
+    }
+    else {
+        for (const req of index.reqs.slice(0, 15)) {
+            const iterInfo = req.iteration ? ` ${req.iteration} / ${req.task}` : ' -';
+            logger_1.logger.info(`   ${req.id} | ${pad(req.name, 16)} | ${pad(req.project, 14)} | ${req.status} |${iterInfo}`);
+        }
+        if (index.reqs.length > 15) {
+            logger_1.logger.info(`   ...（共 ${index.reqs.length} 条，仅显示前 15 条）`);
+        }
+    }
+    // 期次关联
+    if (index.iterations.length > 0) {
+        logger_1.logger.info('');
+        logger_1.logger.info('🔗 期次关联:');
+        for (const iter of index.iterations) {
+            logger_1.logger.info(`   ${iter.name} | ${iter.reqs.length} 个需求 | ${iter.status} | 创建: ${iter.createdAt}`);
+        }
+    }
+    logger_1.logger.info('');
+    logger_1.logger.info(`全量层版本: ${index.version}`);
+    logger_1.logger.info('');
+    if (index.projects.length > 0) {
+        logger_1.logger.info('📋 聚焦: speccore global-status --project=<项目名> 查看项目详情');
+    }
+}
+/**
+ * 指定项目详情
+ */
+async function showProjectDetail(projectName, index) {
+    const proj = index.projects.find((p) => p.name === projectName);
+    if (!proj) {
+        logger_1.logger.error(`项目 "${projectName}" 不在全量层中。`);
+        logger_1.logger.info('运行 speccore global-status 查看所有项目。');
+        return;
+    }
+    const projectReqs = index.reqs.filter((r) => r.project === projectName);
+    logger_1.logger.info('');
+    logger_1.logger.info(`📊 全量层状态 —— ${projectName}`);
+    logger_1.logger.info('');
+    logger_1.logger.info(`项目信息:`);
+    logger_1.logger.info(`   类型: ${proj.type}`);
+    logger_1.logger.info(`   需求数: ${proj.reqCount}`);
+    logger_1.logger.info(`   最后导入: ${proj.lastImport}`);
+    logger_1.logger.info('');
+    logger_1.logger.info(`需求清单（${projectReqs.length} 条）:`);
+    for (const req of projectReqs) {
+        const iterInfo = req.iteration ? `${req.iteration} / ${req.task}` : '-';
+        logger_1.logger.info(`   ${req.id} | ${pad(req.name, 16)} | ${req.status} | ${iterInfo}`);
+    }
+    logger_1.logger.info('');
+    logger_1.logger.info(`📁 需求文件: GLOBAL/PROJECTS/${projectName}/REQUIREMENT.md`);
+    logger_1.logger.info(`📋 元数据文件: GLOBAL/PROJECTS/${projectName}/METADATA.md`);
+}
+/**
+ * 简单字符串填充（中文兼容）
+ */
+function pad(str, width) {
+    const len = [...str].length;
+    if (len >= width)
+        return str;
+    return str + ' '.repeat(width - len);
+}
+//# sourceMappingURL=global-status.js.map

package/dist/commands/global-status.js.map

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

package/dist/commands/goal.d.ts

@@ -0,0 +1,15 @@
+/**
+ * goal - 完整需求交付命令
+ * 从需求描述出发，自动创建任务并生成完整的 Spec 文档结构
+ */
+export interface GoalOptions {
+    name?: string;
+    desc?: string;
+    type?: string;
+    taskId?: string;
+    iteration?: string;
+    backendOnly?: boolean;
+    frontendOnly?: boolean;
+}
+export declare function goalCommand(options: GoalOptions): Promise<void>;
+//# sourceMappingURL=goal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goal.d.ts","sourceRoot":"","sources":["../../src/commands/goal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFrE"}

package/dist/commands/goal.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * goal - 完整需求交付命令
+ * 从需求描述出发，自动创建任务并生成完整的 Spec 文档结构
+ */
+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.goalCommand = goalCommand;
+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 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 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;
+    }
+}
+async function generateTaskId(iteration) {
+    // 查找当前期次下的最大 Task ID
+    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 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;AAOH,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/health.d.ts

@@ -0,0 +1,7 @@
+export interface HealthOptions {
+    iteration?: string;
+    format?: string;
+    trend?: boolean;
+}
+export declare function healthCommand(options: HealthOptions): Promise<void>;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/commands/health.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BzE"}