openfeel 1.0.0

package/dist/core/plan/scheme.js

@@ -0,0 +1,262 @@
+/**
+ * 操作方案管理（Schemer 产出层）
+ * 负责 .openfeel/stages/{stage}/ops/ 下的操作方案文件 CRUD
+ * 创建后自动同步到 flow.json 的 stages/{stage}.ops 中
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { FlowManager } from '../flow-manager.js';
+/**
+ * 生成操作方案的固定 Markdown 模板
+ */
+function generateSchemeTemplate(opId, stageName, title) {
+    return `# ${opId}：${title}
+
+- **阶段**：${stageName}
+- **状态**：pending
+- **前置**：无
+- **负责 Agent**：Executor
+- **最多重试**：3
+
+## 目标
+${title}
+
+## 实施步骤
+- [ ] 待补充
+
+## 产出文件
+- 待补充
+
+## 自测清单
+- [ ] 待补充
+
+## 修正记录
+| 次数 | 时间 | 问题 | 修正内容 |
+|------|------|------|----------|
+`;
+}
+/**
+ * 从文件名中提取 opId
+ * 文件名格式：op-NNN_{title}.md
+ */
+function extractOpId(fileName) {
+    const match = fileName.match(/^(op-\d+)/);
+    return match ? match[1] : null;
+}
+/**
+ * 从文件名中提取标题
+ * 文件名格式：op-NNN_{title}.md
+ */
+function extractTitle(fileName) {
+    // 去掉 op-NNN_ 前缀和 .md 后缀
+    const noPrefix = fileName.replace(/^op-\d+_?/, '');
+    return noPrefix.replace(/\.md$/, '').replace(/_/g, ' ');
+}
+/**
+ * 计算下一个 opId（基于已有方案中的最大编号 +1）
+ */
+function getNextOpId(opsDir) {
+    if (!existsSync(opsDir)) {
+        return 'op-001';
+    }
+    const files = readdirSync(opsDir).filter((f) => f.endsWith('.md'));
+    let maxNum = 0;
+    for (const file of files) {
+        const match = file.match(/^op-(\d+)/);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxNum) {
+                maxNum = num;
+            }
+        }
+    }
+    return `op-${String(maxNum + 1).padStart(3, '0')}`;
+}
+/**
+ * 同步方案到 flow.json
+ * 若 flow.json 不存在或对应 stage 不存在，跳过同步（不报错）
+ */
+function syncToFlowJson(projectPath, stageName, opId, title) {
+    const flowJsonPath = resolve(projectPath, '.openfeel', 'flow.json');
+    if (!existsSync(flowJsonPath)) {
+        return;
+    }
+    try {
+        const flowMgr = new FlowManager(projectPath);
+        const flowData = flowMgr.getData();
+        if (!flowData) {
+            return;
+        }
+        // 检查 stage 是否存在
+        // 若 stage 未在 flow.json 中注册，自动注册
+        if (!flowData.stages[stageName]) {
+            flowData.stages[stageName] = {
+                name: stageName,
+                phase: 'plan_pending',
+                status: 'planned',
+                deps: [],
+                ops: {},
+            };
+        }
+        // 将 op 注册到 stages.{stageName}.ops 中
+        flowData.stages[stageName].ops[opId] = {
+            id: opId,
+            title,
+            state: 'pending',
+            assignee: 'Executor',
+            attempts: 0,
+            max_attempts: 3,
+            checkpoints: {
+                plan: 'pending',
+                scheme: 'pending',
+                exec: { attempts: 0, self: 'pending' },
+                review: 'pending',
+                test: 'pending',
+            },
+        };
+        flowMgr.save();
+    }
+    catch {
+        // 同步失败不阻塞方案创建（静默忽略）
+    }
+}
+/**
+ * 创建操作方案
+ * 在 .openfeel/stages/{stage}/ops/ 下创建 op-NNN_{title}.md
+ * NNN 自动递增（从该阶段的已有方案中计算）
+ * 必须按固定模板生成，包含：目标、实施步骤（checkbox）、产出文件、自测清单、修正记录
+ * 创建后自动同步到 flow.json（如果存在）
+ * @returns opId（如 op-001）
+ */
+export function createScheme(projectPath, stageName, title) {
+    // 1. 确保 .openfeel/stages/{stage}/ops/ 目录存在
+    const opsDir = resolve(projectPath, '.openfeel', 'stages', stageName, 'ops');
+    if (!existsSync(opsDir)) {
+        mkdirSync(opsDir, { recursive: true });
+    }
+    // 2. 计算下一个 opId
+    const opId = getNextOpId(opsDir);
+    // 3. 生成模板内容并写入文件
+    // 文件名中空格用下划线替换
+    const safeTitle = title.replace(/\s+/g, '_');
+    const fileName = `${opId}_${safeTitle}.md`;
+    const filePath = join(opsDir, fileName);
+    const content = generateSchemeTemplate(opId, stageName, title);
+    writeFileSync(filePath, content, 'utf-8');
+    // 4. 同步到 flow.json
+    syncToFlowJson(projectPath, stageName, opId, title);
+    // 5. 返回 opId
+    return opId;
+}
+/**
+ * 读取操作方案
+ * @param opId 操作ID（如 op-001）或完整 opId（如 stage-01.op-001）
+ * @returns Scheme 或 null
+ */
+export function getScheme(projectPath, opId) {
+    const stagesDir = resolve(projectPath, '.openfeel', 'stages');
+    if (!existsSync(stagesDir)) {
+        return null;
+    }
+    let targetStageName;
+    let targetOpId;
+    // 判断 opId 格式：包含 "." 则为完整格式 "stage-01.op-001"
+    const dotIdx = opId.indexOf('.');
+    if (dotIdx !== -1) {
+        targetStageName = opId.substring(0, dotIdx);
+        targetOpId = opId.substring(dotIdx + 1);
+    }
+    else {
+        targetStageName = ''; // 遍历所有阶段查找
+        targetOpId = opId;
+    }
+    // 读取 stages 目录下的子目录
+    const stageEntries = readdirSync(stagesDir, { withFileTypes: true });
+    for (const stageEntry of stageEntries) {
+        if (!stageEntry.isDirectory()) {
+            continue;
+        }
+        // 若指定了阶段名，只检查匹配的目录
+        if (targetStageName && stageEntry.name !== targetStageName) {
+            continue;
+        }
+        const opsDir = join(stagesDir, stageEntry.name, 'ops');
+        if (!existsSync(opsDir)) {
+            continue;
+        }
+        // 在 ops 目录中查找匹配的文件
+        const opFiles = readdirSync(opsDir).filter((f) => f.startsWith(targetOpId) && f.endsWith('.md'));
+        if (opFiles.length === 0) {
+            continue;
+        }
+        // 找到匹配文件，读取内容
+        const matchedFile = opFiles[0]; // 取第一个匹配
+        const filePath = join(opsDir, matchedFile);
+        const content = readFileSync(filePath, 'utf-8');
+        const scheme = {
+            opId: targetOpId,
+            stage: stageEntry.name,
+            title: extractTitle(matchedFile),
+            content,
+            filePath: `.openfeel/stages/${stageEntry.name}/ops/${matchedFile}`,
+        };
+        return scheme;
+    }
+    return null;
+}
+/**
+ * 列出操作方案
+ * @param stageName 可选，不传则列出所有阶段的方案
+ */
+export function listSchemes(projectPath, stageName) {
+    const stagesDir = resolve(projectPath, '.openfeel', 'stages');
+    const result = [];
+    if (!existsSync(stagesDir)) {
+        return result;
+    }
+    // 若指定了阶段名，只遍历该阶段
+    const stageNames = [];
+    if (stageName) {
+        stageNames.push(stageName);
+    }
+    else {
+        const stageEntries = readdirSync(stagesDir, { withFileTypes: true });
+        for (const entry of stageEntries) {
+            if (entry.isDirectory()) {
+                stageNames.push(entry.name);
+            }
+        }
+    }
+    for (const sn of stageNames) {
+        const opsDir = join(stagesDir, sn, 'ops');
+        if (!existsSync(opsDir)) {
+            continue;
+        }
+        const opFiles = readdirSync(opsDir).filter((f) => f.endsWith('.md'));
+        for (const fileName of opFiles) {
+            const opId = extractOpId(fileName);
+            if (!opId) {
+                continue;
+            }
+            const filePath = join(opsDir, fileName);
+            const content = readFileSync(filePath, 'utf-8');
+            result.push({
+                opId,
+                stage: sn,
+                title: extractTitle(fileName),
+                content,
+                filePath: `.openfeel/stages/${sn}/ops/${fileName}`,
+            });
+        }
+    }
+    // 按阶段名 + opId 排序
+    result.sort((a, b) => {
+        const cmp = a.stage.localeCompare(b.stage);
+        if (cmp !== 0) {
+            return cmp;
+        }
+        return a.opId.localeCompare(b.opId);
+    });
+    return result;
+}
+//# sourceMappingURL=scheme.js.map

package/dist/core/plan/scheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme.js","sourceRoot":"","sources":["../../../src/core/plan/scheme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAsB,MAAM,oBAAoB,CAAC;AAgBrE;;GAEG;AACH,SAAS,sBAAsB,CAAC,IAAY,EAAE,SAAiB,EAAE,KAAa;IAC5E,OAAO,KAAK,IAAI,IAAI,KAAK;;WAEhB,SAAS;;;;;;;EAOlB,KAAK;;;;;;;;;;;;;;CAcN,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,wBAAwB;IACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,MAAc;IACjC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;gBACjB,MAAM,GAAG,GAAG,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CACrB,WAAmB,EACnB,SAAiB,EACjB,IAAY,EACZ,KAAa;IAEb,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,gBAAgB;QAChB,gCAAgC;QAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG;gBAC3B,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,cAA+B;gBACtC,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,EAAE;gBACR,GAAG,EAAE,EAAE;aACR,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG;YACrC,EAAE,EAAE,IAAI;YACR,KAAK;YACL,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,CAAC;YACf,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;gBACtC,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,SAAS;aAChB;SACF,CAAC;QAEF,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,SAAiB,EAAE,KAAa;IAChF,2CAA2C;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC7E,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB;IAChB,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEjC,iBAAiB;IACjB,eAAe;IACf,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,SAAS,KAAK,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/D,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE1C,mBAAmB;IACnB,cAAc,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAEpD,aAAa;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,WAAmB,EAAE,IAAY;IACzD,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE9D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,eAAuB,CAAC;IAC5B,IAAI,UAAkB,CAAC;IAEvB,6CAA6C;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC5C,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,eAAe,GAAG,EAAE,CAAC,CAAC,WAAW;QACjC,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,oBAAoB;IACpB,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,mBAAmB;QACnB,IAAI,eAAe,IAAI,UAAU,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAC3D,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,mBAAmB;QACnB,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACjG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,cAAc;QACd,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAW;YACrB,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,UAAU,CAAC,IAAI;YACtB,KAAK,EAAE,YAAY,CAAC,WAAW,CAAC;YAChC,OAAO;YACP,QAAQ,EAAE,oBAAoB,UAAU,CAAC,IAAI,QAAQ,WAAW,EAAE;SACnE,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,SAAkB;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iBAAiB;IACjB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEhD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;gBAC7B,OAAO;gBACP,QAAQ,EAAE,oBAAoB,EAAE,QAAQ,QAAQ,EAAE;aACnD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/plan/stage.d.ts

@@ -0,0 +1,20 @@
+/** 工作阶段 */
+export interface Stage {
+    /** 阶段名，如 stage-01 */
+    name: string;
+    /** 相对路径 .openfeel/stages/stage-01/ */
+    path: string;
+    /** overview.md 内容 */
+    overview: string;
+}
+/**
+ * 添加工作阶段
+ * 在 .openfeel/stages/ 下创建 {name}/ 目录，包含 overview.md 和 status.md 骨架
+ * @param deps 依赖的阶段名列表（可选，写入 overview.md）
+ */
+export declare function addStage(projectPath: string, name: string, deps?: string[]): void;
+/**
+ * 列出所有工作阶段
+ */
+export declare function listStages(projectPath: string): Stage[];
+//# sourceMappingURL=stage.d.ts.map

package/dist/core/plan/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../../src/core/plan/stage.ts"],"names":[],"mappings":"AAQA,WAAW;AACX,MAAM,WAAW,KAAK;IACpB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAiFjF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,EAAE,CAoCvD"}

package/dist/core/plan/stage.js

@@ -0,0 +1,120 @@
+/**
+ * 工作阶段管理
+ * 负责 .openfeel/stages/ 下的阶段目录创建与列取
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { FlowManager } from '../flow-manager.js';
+/**
+ * 添加工作阶段
+ * 在 .openfeel/stages/ 下创建 {name}/ 目录，包含 overview.md 和 status.md 骨架
+ * @param deps 依赖的阶段名列表（可选，写入 overview.md）
+ */
+export function addStage(projectPath, name, deps) {
+    const stagesDir = resolve(projectPath, '.openfeel', 'stages');
+    // 确保 stages 目录存在
+    if (!existsSync(stagesDir)) {
+        mkdirSync(stagesDir, { recursive: true });
+    }
+    const stageDir = join(stagesDir, name);
+    // 确保阶段目录存在
+    if (!existsSync(stageDir)) {
+        mkdirSync(stageDir, { recursive: true });
+    }
+    // 若目录已存在，不覆盖已有文件，只创建缺失的
+    // 创建 overview.md（若不存在）
+    const overviewPath = join(stageDir, 'overview.md');
+    if (!existsSync(overviewPath)) {
+        const depsText = deps && deps.length > 0 ? deps.map((d) => `- ${d}`).join('\n') : '无';
+        const overviewContent = `# ${name}
+
+## 目标
+
+> 待补充
+
+## 依赖
+
+${depsText}
+
+## 操作方案
+
+> 待补充
+`;
+        writeFileSync(overviewPath, overviewContent, 'utf-8');
+    }
+    // 创建 status.md（若不存在）
+    const statusPath = join(stageDir, 'status.md');
+    if (!existsSync(statusPath)) {
+        const statusContent = `# ${name} 状态
+
+- **执行模式**：manual
+- **自动推进**：disabled
+- **状态**：planned
+- **当前责任 Agent**：user
+- **上一责任 Agent**：none
+- **更新时间**：${new Date().toISOString().replace('T', ' ').substring(0, 16)}
+
+## Worktree / Session
+
+- **工作模式**：manual
+- **分支名**：-
+- **Session 名称**：-
+- **合并状态**：not_started
+- **清理策略**：manual
+
+## 当前任务
+
+> 待补充
+
+## 阻塞 / 暂停原因
+
+无
+
+## 状态记录
+
+| 时间 | Agent | 状态变化 | 说明 |
+|------|-------|----------|------|
+| ${new Date().toISOString().replace('T', ' ').substring(0, 16)} | user | planned | 阶段已创建 |
+`;
+        writeFileSync(statusPath, statusContent, 'utf-8');
+    }
+    // 同步到 flow.json（若 flow.json 存在）
+    const flowMgr = new FlowManager(projectPath);
+    if (flowMgr.isLoaded()) {
+        flowMgr.registerStage(name, deps ?? []);
+        flowMgr.save();
+    }
+}
+/**
+ * 列出所有工作阶段
+ */
+export function listStages(projectPath) {
+    const stagesDir = resolve(projectPath, '.openfeel', 'stages');
+    // 目录不存在时返回空列表
+    if (!existsSync(stagesDir)) {
+        return [];
+    }
+    const result = [];
+    // 遍历子目录
+    const entries = readdirSync(stagesDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const stageDir = join(stagesDir, entry.name);
+        const overviewPath = join(stageDir, 'overview.md');
+        let overview = '';
+        if (existsSync(overviewPath)) {
+            overview = readFileSync(overviewPath, 'utf-8');
+        }
+        result.push({
+            name: entry.name,
+            path: `.openfeel/stages/${entry.name}/`,
+            overview,
+        });
+    }
+    // 按名称排序
+    result.sort((a, b) => a.name.localeCompare(b.name));
+    return result;
+}
+//# sourceMappingURL=stage.js.map

package/dist/core/plan/stage.js.map

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

package/dist/core/public-logger.d.ts

@@ -0,0 +1,84 @@
+/** 里程碑事件 */
+export interface MilestoneEvent {
+    action: string;
+    stageId?: string;
+    durationMs?: number;
+    finalPhase?: string;
+    [key: string]: unknown;
+}
+/** 日志事件详情 */
+export interface LogEventDetail {
+    /** 操作类型（如 advance_phase, attempt_pass, review_added 等） */
+    action: string;
+    /** 关联的操作 ID（可选） */
+    opId?: string | null;
+    /** 变更前状态（可选） */
+    from?: string;
+    /** 变更后状态（可选） */
+    to?: string;
+    /** 其他补充信息 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * PublicLogger 单例类
+ * 负责写入公共日志并维护索引文件。
+ * 构造时从 .openfeel/.info.json 加载用户名。
+ */
+export declare class PublicLogger {
+    private static instance;
+    private projectPath;
+    private username;
+    private constructor();
+    /**
+     * 获取或创建 PublicLogger 单例
+     * @param projectPath 项目根路径
+     */
+    static getInstance(projectPath: string): PublicLogger;
+    /**
+     * 重置单例（仅供测试使用）
+     */
+    static resetInstance(): void;
+    /**
+     * 记录状态变更事件（advancePhase / recordAttempt）
+     * @param detail 变更详情
+     */
+    logPhaseChange(detail: LogEventDetail): void;
+    /**
+     * 记录审查事件（addReview / addAutoFixReview）
+     * @param detail 审查详情
+     */
+    logReviewEvent(detail: LogEventDetail): void;
+    /**
+     * 记录测试事件
+     * @param detail 测试详情
+     */
+    logTestEvent(detail: LogEventDetail): void;
+    /**
+     * 记录里程碑事件（阶段完成、测试通过、归档完成等）
+     * 此类重要事件逐条记录，不参与批量聚合
+     */
+    logMilestone(title: string, event: MilestoneEvent): void;
+    /** 获取当前用户名 */
+    getUsername(): string;
+    /** 从 .openfeel/.info.json 加载用户名 */
+    private loadUsername;
+    /** 写入日志并维护索引（乐观操作） */
+    private writeLog;
+    /** 确保年/月/日目录存在，返回日目录路径 */
+    private ensureDateDir;
+    /** 计算当日的下一个 NNN 值（当日已有日志文件数 + 1） */
+    private computeNextNnn;
+    /** 构建日志文件名 yyyy-mm-dd-{username}-NNN.md */
+    private buildFileName;
+    /** 构建日志文件内容 */
+    private buildLogContent;
+    /** 更新当日 day_index.md */
+    private updateDayIndex;
+    /** 更新根级 index.md（日期索引） */
+    private updateRootIndex;
+    /** 更新根级 log.md（最近 30 条摘要，倒序插入顶部） */
+    private updateLogMd;
+}
+/** 格式化日期为 yyyy-mm-dd */
+export declare function formatDate(date: Date): string;
+//# sourceMappingURL=public-logger.d.ts.map

package/dist/core/public-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-logger.d.ts","sourceRoot":"","sources":["../../src/core/public-logger.ts"],"names":[],"mappings":"AAcA,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;IAKP;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;IAOrD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAM5B;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAI5C;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAI5C;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAI1C;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAOxD,cAAc;IACd,WAAW,IAAI,MAAM;IAIrB,mCAAmC;IACnC,OAAO,CAAC,YAAY;IAgBpB,sBAAsB;IACtB,OAAO,CAAC,QAAQ;IAqBhB,0BAA0B;IAC1B,OAAO,CAAC,aAAa;IAmBrB,oCAAoC;IACpC,OAAO,CAAC,cAAc;IAsBtB,2CAA2C;IAC3C,OAAO,CAAC,aAAa;IAKrB,eAAe;IACf,OAAO,CAAC,eAAe;IAsCvB,wBAAwB;IACxB,OAAO,CAAC,cAAc;IA6BtB,0BAA0B;IAC1B,OAAO,CAAC,eAAe;IAiCvB,oCAAoC;IACpC,OAAO,CAAC,WAAW;CA0DpB;AAID,wBAAwB;AACxB,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAK7C"}