speccore 8.3.174 → 8.3.176

package/dist/core/handoff-generator.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateHandoff = generateHandoff;
+exports.getHandoffPath = getHandoffPath;
+exports.handoffExists = handoffExists;
+/**
+ * handoff-generator — 阶段传递摘要生成器
+ *
+ * 每个 Pipeline 阶段完成后，生成精简的传递摘要给下一阶段 AI 使用。
+ * 核心原则：完整版存文件，传递版只给下一阶段 AI 看。
+ */
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const HANDOFF_LIMITS = {
+    'analyze-split': { maxLines: 60, requiredSections: ['modules', 'dependencies', 'constraints'] },
+    'split-plan': { maxLines: 60, requiredSections: ['tasks', 'dependencies', 'staffing'] },
+    'plan-execute': { maxLines: 150, requiredSections: ['currentTask', 'upstreamContracts', 'globalConstraints'] },
+    'execute-review': { maxLines: 80, requiredSections: ['deliverables', 'acceptanceCriteria'] },
+    'review-done': { maxLines: 40, requiredSections: ['reviewResults', 'openIssues'] },
+};
+/**
+ * 生成阶段传递摘要
+ */
+async function generateHandoff(from, to, iteration) {
+    const iterDir = `Iteration-${iteration.replace(/^Iteration-/, '')}`;
+    const handoffDir = (0, path_1.join)('.speccore', 'local', 'handoffs');
+    await (0, fs_extra_1.ensureDir)(handoffDir);
+    const handoffKey = `${from}-${to}`;
+    const config = HANDOFF_LIMITS[handoffKey];
+    if (!config) {
+        throw new Error(`未知阶段传递: ${from} → ${to}`);
+    }
+    const summary = await buildHandoffContent(from, to, iterDir, config);
+    const handoffPath = (0, path_1.join)(handoffDir, `handoff-${handoffKey}.md`);
+    await (0, fs_extra_1.writeFile)(handoffPath, summary);
+    return handoffPath;
+}
+/**
+ * 构建传递摘要内容
+ */
+async function buildHandoffContent(from, to, iterDir, config) {
+    const lines = [];
+    // 头部信息
+    lines.push(`# 阶段传递：${from} → ${to}`);
+    lines.push('');
+    lines.push('## 1. 核心信息');
+    lines.push('');
+    lines.push(`| 项目 | 内容 |`);
+    lines.push(`| :--- | :--- |`);
+    lines.push(`| 迭代 | ${iterDir} |`);
+    lines.push(`| 阶段 | ${from} → ${to} |`);
+    lines.push(`| 时间 | ${new Date().toISOString().split('T')[0]} |`);
+    lines.push('');
+    // 根据阶段组合生成不同内容
+    switch (`${from}-${to}`) {
+        case 'analyze-split':
+            await appendAnalyzeToSplit(lines, iterDir);
+            break;
+        case 'split-plan':
+            await appendSplitToPlan(lines, iterDir);
+            break;
+        case 'plan-execute':
+            await appendPlanToExecute(lines, iterDir);
+            break;
+        case 'execute-review':
+            await appendExecuteToReview(lines, iterDir);
+            break;
+        case 'review-done':
+            await appendReviewToDone(lines, iterDir);
+            break;
+    }
+    // 文件引用
+    lines.push('');
+    lines.push('## 文件引用（需要时自行读取）');
+    lines.push('');
+    lines.push('| 文件 | 路径 | 用途 |');
+    lines.push('| :--- | :--- | :--- |');
+    lines.push(`| 完整需求 | ${iterDir}/010-requirements/converted/ | 查看需求细节 |`);
+    lines.push(`| 功能单元 | ${iterDir}/010-requirements/features/ | 按模块查看需求 |`);
+    lines.push(`| 全局规格 | ${iterDir}/020-specs/overview/ | 查看分析结果 |`);
+    lines.push('');
+    const result = lines.join('\n');
+    // 校验行数上限
+    const lineCount = result.split('\n').length;
+    if (lineCount > config.maxLines) {
+        // 截断到上限
+        const truncated = result.split('\n').slice(0, config.maxLines).join('\n');
+        return truncated + `\n\n> ⚠️ 摘要已截断（原 ${lineCount} 行 > 上限 ${config.maxLines} 行）\n`;
+    }
+    return result;
+}
+/**
+ * analyze → split: 功能模块清单 + 依赖关系 + 关键约束
+ */
+async function appendAnalyzeToSplit(lines, iterDir) {
+    const featuresDir = (0, path_1.join)(iterDir, '010-requirements', 'features');
+    lines.push('## 2. 功能模块清单');
+    lines.push('');
+    lines.push('| 模块 | 涉及端 | 优先级 | 依赖 | 摘要 |');
+    lines.push('| :--- | :--- | :--- | :--- | :--- |');
+    if (await (0, fs_extra_1.pathExists)(featuresDir)) {
+        const entries = await (0, fs_extra_1.readdir)(featuresDir, { withFileTypes: true });
+        const units = entries.filter(e => e.isDirectory() && !e.name.startsWith('.'));
+        for (const unit of units.slice(0, 20)) { // 限制行数
+            const readmePath = (0, path_1.join)(featuresDir, unit.name, 'README.md');
+            let summary = '';
+            if (await (0, fs_extra_1.pathExists)(readmePath)) {
+                const content = await (0, fs_extra_1.readFile)(readmePath, 'utf-8');
+                const firstLine = content.split('\n')[0] || '';
+                summary = firstLine.replace(/^#\s*/, '').slice(0, 30);
+            }
+            lines.push(`| ${unit.name} | 待分析 | 中 | 无 | ${summary} |`);
+        }
+    }
+    else {
+        lines.push('| (未拆分) | 全部 | 中 | 无 | 见 converted/ |');
+    }
+    lines.push('');
+    lines.push('## 3. 依赖关系');
+    lines.push('');
+    lines.push('```mermaid');
+    lines.push('flowchart LR');
+    lines.push('    A[需求分析] --> B[任务拆分]');
+    lines.push('```');
+    lines.push('');
+    lines.push('## 4. 关键约束（≤5条）');
+    lines.push('');
+    lines.push('- 待 analyze 阶段补充');
+    lines.push('');
+}
+/**
+ * split → plan: 任务清单 + 人员配置 + 关键路径
+ */
+async function appendSplitToPlan(lines, iterDir) {
+    const tasksDir = (0, path_1.join)(iterDir, '030-tasks');
+    lines.push('## 2. 任务清单');
+    lines.push('');
+    lines.push('| 任务 ID | 名称 | 依赖 | 工时 | 涉及端 |');
+    lines.push('| :--- | :--- | :--- | :--- | :--- |');
+    if (await (0, fs_extra_1.pathExists)(tasksDir)) {
+        const entries = await (0, fs_extra_1.readdir)(tasksDir, { withFileTypes: true });
+        const tasks = entries.filter(e => e.isDirectory() && e.name.startsWith('Task-'));
+        for (const task of tasks.slice(0, 30)) {
+            lines.push(`| ${task.name} | 待填写 | 无 | 待评估 | 待分析 |`);
+        }
+    }
+    else {
+        lines.push('| Task-001 | 示例任务 | 无 | 8h | 全部 |');
+    }
+    lines.push('');
+    lines.push('## 3. 关键路径');
+    lines.push('');
+    lines.push('- 待 plan 阶段计算');
+    lines.push('');
+}
+/**
+ * plan → execute: 当前任务 Spec + 上游依赖契约
+ */
+async function appendPlanToExecute(lines, iterDir) {
+    lines.push('## 2. 当前任务规格');
+    lines.push('');
+    lines.push('- 执行时由 CLI 动态加载当前任务的 REQ.md + TECH.md');
+    lines.push('- 只加载当前任务，不加载其他任务');
+    lines.push('');
+    lines.push('## 3. 上游依赖契约');
+    lines.push('');
+    lines.push('- 由 CLI 自动读取上游任务的 `_shared/API_CONTRACT.yaml`');
+    lines.push('- 只传契约，不传实现');
+    lines.push('');
+    lines.push('## 4. 全局约束');
+    lines.push('');
+    lines.push('- 技术栈见 CONSTITUTION.md');
+    lines.push('- 命名规范见 PROJECT.yaml');
+    lines.push('');
+}
+/**
+ * execute → review: 产出物清单 + 验收标准
+ */
+async function appendExecuteToReview(lines, iterDir) {
+    lines.push('## 2. 产出物清单');
+    lines.push('');
+    lines.push('- 代码文件（CONSTITUTION.md 指定的源码路径）');
+    lines.push('- 测试用例（TEST.md）');
+    lines.push('- API 契约（_shared/API_CONTRACT.yaml）');
+    lines.push('');
+    lines.push('## 3. 验收标准');
+    lines.push('');
+    lines.push('- 编译通过');
+    lines.push('- 测试通过');
+    lines.push('- 无占位符');
+    lines.push('');
+}
+/**
+ * review → done: 审查结果 + 未解决问题
+ */
+async function appendReviewToDone(lines, iterDir) {
+    lines.push('## 2. 审查结果');
+    lines.push('');
+    lines.push('- 待 review 阶段填写');
+    lines.push('');
+    lines.push('## 3. 未解决问题');
+    lines.push('');
+    lines.push('- [ ] 待确认');
+    lines.push('');
+}
+/**
+ * 读取 handoff 文件路径
+ */
+function getHandoffPath(from, to) {
+    return (0, path_1.join)('.speccore', 'local', 'handoffs', `handoff-${from}-${to}.md`);
+}
+/**
+ * 检查 handoff 是否存在
+ */
+async function handoffExists(from, to) {
+    return (0, fs_extra_1.pathExists)(getHandoffPath(from, to));
+}
+//# sourceMappingURL=handoff-generator.js.map

package/dist/core/handoff-generator.js.map

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

package/dist/core/knowledge-graph.js

@@ -174,7 +174,7 @@ async function scanSpecs(iterDir) {
             mtime,
         });
     }
-    // v8.3.171+: 扫描各端子目录（唯一路径 020-specs/{端}/，删除 platforms/ 旧路径兼容）
+    // 扫描各端子目录（唯一路径 020-specs/{端}/）
     // v8.3.65+: 加入 requirements（黄金需求目录，由 scanRequirements 单独扫描）
     const knownNonPlatformDirs = new Set(['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'snapshots', 'requirements']);
     const platformDirs = [];
@@ -300,9 +300,9 @@ async function scanBusinessCodeMappings(iterDir) {
     const specsDir = (0, path_1.join)(iterDir, '020-specs');
     if (!(await (0, fs_extra_1.pathExists)(specsDir)))
         return { entities, relations };
-    // v8.3.122+: 同时兼容新旧两种路径结构
+    // v8.3.122+: 同时扫描多种路径结构
     // 新结构: 020-specs/{feature}/{platform}/TECH.md
-    // 旧结构: 020-specs/{platform}/TECH.md
+    // 结构: 020-specs/{platform}/TECH.md
     const knownNonPlatformDirs = new Set(['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'platforms', 'snapshots', 'global', 'overview', 'requirements']);
     const specsEntries = await (0, fs_extra_1.readdir)(specsDir, { withFileTypes: true });
     for (const featureEntry of specsEntries) {
@@ -310,10 +310,10 @@ async function scanBusinessCodeMappings(iterDir) {
             continue;
         const featureName = featureEntry.name;
         const featureDir = (0, path_1.join)(specsDir, featureName);
-        // 检测是旧结构（直接有 TECH.md）还是新结构（有子目录）
+        // 检测结构（直接有 TECH.md）还是新结构（有子目录）
         const hasTechMdDirectly = await (0, fs_extra_1.pathExists)((0, path_1.join)(featureDir, 'TECH.md'));
         if (hasTechMdDirectly) {
-            // 旧结构: 020-specs/{platform}/TECH.md — 把 featureName 当成 platformName
+            // 结构: 020-specs/{platform}/TECH.md — 把 featureName 当成 platformName
             await processTechMdForMappings(featureDir, featureName, '', entities, relations);
         }
         else {
@@ -440,7 +440,7 @@ async function scanTasks(iterDir) {
     const tasksDir = (0, path_1.join)(iterDir, '030-tasks');
     if (!(await (0, fs_extra_1.pathExists)(tasksDir)))
         return { entities, relations };
-    // 扫描类型子目录 + 旧布局
+    // 扫描类型子目录
     const taskDirs = [];
     for (const type of task_paths_1.TASK_TYPES) {
         const typeDir = (0, path_1.join)(tasksDir, type);
@@ -453,7 +453,7 @@ async function scanTasks(iterDir) {
             }
         }
     }
-    // 旧布局: 030-tasks/Task-XXX/
+    // 布局: 030-tasks/Task-XXX/
     const rootEntries = await (0, fs_extra_1.readdir)(tasksDir, { withFileTypes: true });
     for (const e of rootEntries) {
         if (e.isDirectory() && e.name.startsWith('Task-')) {
@@ -599,7 +599,7 @@ async function scanTasks(iterDir) {
                 }
             }
             else {
-                // 兼容：端目录下无子任务，端本身作为子任务（如旧数据的单端任务）
+                // 端目录下无子任务，端本身作为子任务（单端任务）
                 const platformTaskMd = (0, path_1.join)(platformPath, 'TASK.md');
                 let subTitle = `${title} — ${de.name}`;
                 let subStatus = 'pending';