speccore 8.3.176 → 8.3.178

package/dist/core/plan-graph.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeBatches = computeBatches;
+exports.findCriticalPath = findCriticalPath;
+exports.detectResourceConflicts = detectResourceConflicts;
+exports.calculatePlatformCoverage = calculatePlatformCoverage;
+exports.buildPlanGraph = buildPlanGraph;
+exports.generatePlanJson = generatePlanJson;
+exports.buildPlanDecisionPrompt = buildPlanDecisionPrompt;
+/**
+ * 从 TaskState 提取元数据（只取计划需要的字段）
+ */
+function extractMeta(t) {
+    return {
+        id: t.id,
+        name: t.name,
+        depends_on: t.dependencies || [],
+        platforms: t.platform ? [t.platform] : [],
+        estimated_hours: t.estimatedHours || 0,
+        priority: t.priority,
+        assignee: t.assignee || '未分配',
+        status: t.status,
+    };
+}
+/**
+ * 构建依赖图并计算执行批次（拓扑排序分层）
+ */
+function computeBatches(tasks) {
+    const graph = new Map();
+    const inDegree = new Map();
+    // 初始化
+    for (const t of tasks) {
+        graph.set(t.id, t.dependencies || []);
+        inDegree.set(t.id, (t.dependencies || []).length);
+    }
+    const batches = [];
+    let remaining = new Set(tasks.map(t => t.id));
+    while (remaining.size > 0) {
+        // 找出入度为 0 的任务（无未完成的依赖）
+        const currentBatch = [];
+        for (const taskId of remaining) {
+            if ((inDegree.get(taskId) || 0) === 0) {
+                currentBatch.push(taskId);
+            }
+        }
+        if (currentBatch.length === 0) {
+            // 有环，剩余任务组成一批
+            batches.push({ batch: batches.length + 1, tasks: Array.from(remaining) });
+            break;
+        }
+        batches.push({ batch: batches.length + 1, tasks: currentBatch });
+        // 移除已处理的任务，更新入度
+        for (const taskId of currentBatch) {
+            remaining.delete(taskId);
+            for (const [id, deps] of graph) {
+                if (deps.includes(taskId)) {
+                    inDegree.set(id, (inDegree.get(id) || 0) - 1);
+                }
+            }
+        }
+    }
+    return batches;
+}
+/**
+ * 计算关键路径（耗时最长的依赖链）
+ */
+function findCriticalPath(tasks, batches) {
+    const taskMap = new Map(tasks.map(t => [t.id, t]));
+    const dp = new Map();
+    function calc(taskId) {
+        if (dp.has(taskId))
+            return dp.get(taskId);
+        const task = taskMap.get(taskId);
+        const hours = task?.estimatedHours || 0;
+        const deps = task?.dependencies || [];
+        if (deps.length === 0) {
+            const result = { duration: hours, path: [taskId] };
+            dp.set(taskId, result);
+            return result;
+        }
+        let maxDep = { duration: 0, path: [] };
+        for (const dep of deps) {
+            const depResult = calc(dep);
+            if (depResult.duration > maxDep.duration) {
+                maxDep = depResult;
+            }
+        }
+        const result = {
+            duration: maxDep.duration + hours,
+            path: [...maxDep.path, taskId],
+        };
+        dp.set(taskId, result);
+        return result;
+    }
+    let best = { duration: 0, path: [] };
+    for (const t of tasks) {
+        const result = calc(t.id);
+        if (result.duration > best.duration) {
+            best = result;
+        }
+    }
+    return best.path;
+}
+/**
+ * 检测资源冲突（同一人在同一批次有多个任务）
+ */
+function detectResourceConflicts(tasks, batches) {
+    const taskMap = new Map(tasks.map(t => [t.id, t]));
+    const conflicts = [];
+    for (const batch of batches) {
+        const assigneeMap = new Map();
+        for (const taskId of batch.tasks) {
+            const task = taskMap.get(taskId);
+            if (!task || !task.assignee)
+                continue;
+            const list = assigneeMap.get(task.assignee) || [];
+            list.push(taskId);
+            assigneeMap.set(task.assignee, list);
+        }
+        for (const [assignee, taskIds] of assigneeMap) {
+            if (taskIds.length > 1) {
+                conflicts.push({
+                    type: 'resource',
+                    description: `${assignee} 在批次 ${batch.batch} 中同时负责 ${taskIds.length} 个任务`,
+                    involved: taskIds,
+                });
+            }
+        }
+    }
+    return conflicts;
+}
+/**
+ * 计算端覆盖统计
+ */
+function calculatePlatformCoverage(tasks) {
+    const coverage = {};
+    for (const t of tasks) {
+        if (t.platform) {
+            coverage[t.platform] = (coverage[t.platform] || 0) + 1;
+        }
+    }
+    return coverage;
+}
+/**
+ * 构建完整的计划图（CLI 算图结果）
+ */
+function buildPlanGraph(tasks) {
+    const batches = computeBatches(tasks);
+    const criticalPath = findCriticalPath(tasks, batches);
+    const conflicts = detectResourceConflicts(tasks, batches);
+    const platformCoverage = calculatePlatformCoverage(tasks);
+    const totalDuration = criticalPath.reduce((sum, id) => {
+        const t = tasks.find(task => task.id === id);
+        return sum + (t?.estimatedHours || 0);
+    }, 0);
+    return {
+        tasks: tasks.map(extractMeta),
+        batches,
+        criticalPath,
+        totalDuration,
+        conflicts,
+        platformCoverage,
+    };
+}
+/**
+ * 生成结构化 JSON（给 AI 的输入）
+ */
+function generatePlanJson(graph) {
+    return JSON.stringify({
+        iteration: graph.tasks.length > 0 ? '当前迭代' : '',
+        summary: {
+            total_tasks: graph.tasks.length,
+            total_batches: graph.batches.length,
+            total_duration_hours: graph.totalDuration,
+            critical_path: graph.criticalPath,
+        },
+        tasks: graph.tasks,
+        batches: graph.batches,
+        conflicts: graph.conflicts,
+        platform_coverage: graph.platformCoverage,
+    }, null, 2);
+}
+/**
+ * 构建 AI 决策 Prompt（基于 CLI 算好的图）
+ */
+function buildPlanDecisionPrompt(json) {
+    return `# 任务: 制定开发计划\n\n` +
+        `## 输入数据（CLI 自动计算）\n\n` +
+        `以下数据由 CLI 从任务目录扫描并计算得出：\n\n` +
+        `\`\`\`json
+${json}
+\`\`\`
+
+` +
+        `## 需要你判断的问题\n\n` +
+        `1. **优先级冲突**：同一批次内是否有高优先级任务应该提前？\n` +
+        `2. **资源冲突**：是否有人员同时负责多个任务需要调整？\n` +
+        `3. **风险识别**：关键路径上的任务是否有延期风险？\n` +
+        `4. **批次优化**：是否有任务可以合并或拆分以优化工期？\n` +
+        `5. **依赖合理性**：是否有循环依赖或缺失依赖需要修复？\n\n` +
+        `## 输出要求\n\n` +
+        `1. 生成分批次执行计划（Mermaid 甘特图或表格）\n` +
+        `2. 标注关键路径上的任务\n` +
+        `3. 列出所有冲突和建议的解决方案\n` +
+        `4. 使用 [DOC:PLAN] 标记输出\n\n` +
+        `## 注意\n\n` +
+        `- 不要重新计算依赖关系（CLI 已经算好）\n` +
+        `- 不要重新估算工时（使用输入数据中的值）\n` +
+        `- 只做判断和决策，不做计算\n`;
+}
+//# sourceMappingURL=plan-graph.js.map

package/dist/core/plan-graph.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "8.3.176",
+  "version": "8.3.178",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",