@winspan/claude-forge 0.2.14 → 0.3.0

package/dist/utils/plan-reader.js

@@ -0,0 +1,121 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * 扫描项目 docs/plan-*.md，返回包含未完成任务的计划文件路径列表（按文件名倒序，最新在前）
+ */
+function findPlanFiles(projectPath) {
+    const docsDir = path.join(projectPath, 'docs');
+    try {
+        if (!fs.existsSync(docsDir))
+            return [];
+        return fs.readdirSync(docsDir)
+            .filter(f => /^plan-.+\.md$/.test(f))
+            .sort()
+            .reverse()
+            .map(f => path.join(docsDir, f));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 读取项目 docs/plan-*.md，返回最新的含未完成任务的计划文件。
+ * 按文件名倒序扫描，找到第一个有 pending/in-progress 任务的文件即返回。
+ */
+export function readPlanFile(projectPath) {
+    const files = findPlanFiles(projectPath);
+    for (const filePath of files) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const tasks = parsePlanTasks(content);
+            if (tasks.length === 0)
+                continue;
+            const hasInProgress = tasks.some(t => t.status === 'in-progress');
+            const hasIncomplete = tasks.some(t => t.status === 'pending' || t.status === 'in-progress');
+            if (!hasIncomplete)
+                continue;
+            return { filePath, tasks, hasInProgress, hasIncomplete };
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * 返回当前项目最新 plan 文件路径（用于提示用户在哪里写计划）。
+ * 若已有 plan 文件则返回最新的，否则返回建议新建的路径。
+ */
+export function getPlanFilePath(projectPath) {
+    const files = findPlanFiles(projectPath);
+    if (files.length > 0)
+        return files[0];
+    // 建议新建：docs/plan-v1.md
+    return path.join(projectPath, 'docs', 'plan-v1.md');
+}
+/**
+ * 构建会话开始时注入的计划上下文。
+ * 若项目 docs/ 下没有含未完成任务的 plan 文件，返回 null。
+ */
+export function buildSessionStartPlanContext(projectPath) {
+    try {
+        const planFile = readPlanFile(projectPath);
+        if (!planFile)
+            return null;
+        const { filePath, tasks } = planFile;
+        const fileName = path.basename(filePath);
+        const pending = tasks.filter(t => t.status === 'pending');
+        const inProgress = tasks.filter(t => t.status === 'in-progress');
+        const done = tasks.filter(t => t.status === 'done');
+        const parts = [];
+        parts.push(`[Forge 计划] 当前计划文件：docs/${fileName}`);
+        if (inProgress.length > 0) {
+            parts.push('进行中：');
+            for (const t of inProgress)
+                parts.push(`  - [~] ${t.title}`);
+        }
+        if (pending.length > 0) {
+            parts.push('待处理：');
+            for (const t of pending)
+                parts.push(`  - [ ] ${t.title}`);
+        }
+        if (done.length > 0) {
+            parts.push(`已完成：${done.length} 项`);
+        }
+        parts.push('请问是否继续上述任务？若是，直接开始；若否，请说明新需求。');
+        return parts.join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 从 Markdown 内容解析任务清单
+ * - `- [ ]` → pending
+ * - `- [x]` / `- [X]` → done
+ * - 其他任何标记（`[~]` `[-]` `[>]` 等）→ in-progress
+ */
+function parsePlanTasks(content) {
+    const tasks = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const match = line.match(/^\s*-\s+\[([^\]]*)\]\s+(.+)$/);
+        if (!match)
+            continue;
+        const marker = match[1];
+        const title = match[2].trim();
+        let status;
+        if (marker === '') {
+            status = 'pending';
+        }
+        else if (marker.toLowerCase() === 'x') {
+            status = 'done';
+        }
+        else {
+            status = 'in-progress';
+        }
+        tasks.push({ title, status });
+    }
+    return tasks;
+}
+//# sourceMappingURL=plan-reader.js.map

package/dist/utils/plan-reader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@winspan/claude-forge",
-  "version": "0.2.14",
+  "version": "0.3.0",
   "description": "SDLC intelligent orchestration engine for Claude Code",
   "main": "dist/cli/index.js",
   "type": "module",