openfeel 1.0.8 → 1.1.0

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

@@ -0,0 +1,64 @@
+/** 短名（无版本前缀）默认系列 */
+export declare const DEFAULT_SERIES = "v1";
+/** 短名规范化为完整 stageId 时的默认四级版本前缀（与 init 示例阶段一致） */
+export declare const DEFAULT_STAGE_VERSION = "v1.0.0";
+/** stageId 解析结果 */
+export interface ParsedStageId {
+    /** 大版本系列，如 v1 */
+    series: string;
+    /** 阶段目录名，如 stage-34 */
+    stageDir: string;
+    /** 规范化后的完整 stageId（短名补齐版本前缀） */
+    fullStageId: string;
+}
+/**
+ * 解析 stageId → { series, stageDir, fullStageId }
+ *
+ * 支持三种格式（决策 2 正向映射）：
+ * - 完整：v1.0.0-stage-34 → { series: 'v1', stageDir: 'stage-34', fullStageId: 'v1.0.0-stage-34' }
+ * - 历史：v4-stage-04    → { series: 'v4', stageDir: 'stage-04', fullStageId: 'v4-stage-04' }
+ * - 短名：stage-01       → { series: 'v1', stageDir: 'stage-01', fullStageId: 'v1.0.0-stage-01' }
+ *
+ * 无法解析（如 'foo'、'v1'、空字符串）返回 null。
+ * 注意 stageDir 保留原始数字格式（stage-04 不丢前导零），NN 用捕获组原样保留，不做 parseInt。
+ */
+export declare function parseStageId(stageId: string): ParsedStageId | null;
+/**
+ * stageId → plan 相对目录（不含 .openfeel 前缀）
+ * 例：v1.0.0-stage-34 → 'plan/v1/stage-34/'；stage-01 → 'plan/v1/stage-01/'
+ * 无法解析返回 null。
+ */
+export declare function stageIdToPlanDir(stageId: string): string | null;
+/**
+ * 短名/完整 stageId → 规范化完整 stageId
+ * 短名 stage-01 → v1.0.0-stage-01；完整/历史格式原样返回。
+ * 无法解析返回 null。
+ */
+export declare function normalizeStageId(stageId: string): string | null;
+/**
+ * 目录名（stage-NN）→ 完整 stageId（反向映射，回查 flow.json stages 键）
+ *
+ * 目录名 stage-33 无法唯一还原版本前缀，须回查 flow.json 匹配 `*-stage-33`。
+ * 去歧义规则（遗留风险 1）：若多个 stageId 匹配 `*-stage-{NN}`，
+ *   1. 优先 pipeline.current.stage（若在匹配集中）；
+ *   2. 否则按版本前缀字典序降序取最新（v1.0.0 > v0.9 > v0.5）。
+ * 注：同 stage-NN 跨多版本前缀重复在理论上不应发生，此规则仅兜底。
+ *
+ * @returns 完整 stageId，找不到匹配或 flow.json 不可读时返回 null
+ */
+export declare function planDirToStageId(projectPath: string, stageDir: string): string | null;
+/**
+ * 三级回退查找 status.md（决策 4，供 flow-manager 与命令层复用）
+ *
+ * 1. plan/{series}/stage-NN/status.md（解析 stageId → 精确路径，首选）
+ * 2. plan/ 下递归搜索 stage-NN/status.md（fast-glob 递归，兼容 series 变化/旧平铺）
+ * 3. stages/{stageId}/status.md（历史遗留，只读兜底）
+ *
+ * 性能说明（遗留风险 3）：第 1 级精确路径命中率最高（新写入均在此），
+ * 第 2 级 fast-glob 仅在精确未命中时触发（兼容旧数据/系列变化的罕见场景），
+ * 因此对 flow status 高频调用性能影响可控；本 stage 不做缓存，留作后续观察。
+ *
+ * @returns status.md 绝对路径，三级均未命中返回 null
+ */
+export declare function findStageStatusPath(projectPath: string, stageId: string): string | null;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/core/plan/path.ts"],"names":[],"mappings":"AAaA,oBAAoB;AACpB,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAE9C,mBAAmB;AACnB,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsBlE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BrF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+BvF"}

package/dist/core/plan/path.js

@@ -0,0 +1,150 @@
+/**
+ * 阶段路径映射工具 — stageId ↔ plan 目录双向映射的唯一权威
+ *
+ * 统一规则（决策 1/2）：
+ * - plan 目录结构：.openfeel/plan/{series}/stage-{NN}/
+ * - {series} = 大版本系列 = v{MAJOR}（如 v1、v4）
+ * - {stage} = 阶段目录名 = stage-{NN}（不含版本前缀）
+ * - flow.json stageId 是权威标识（唯一键），目录名是派生组织单位
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import fastGlob from 'fast-glob';
+/** 短名（无版本前缀）默认系列 */
+export const DEFAULT_SERIES = 'v1';
+/** 短名规范化为完整 stageId 时的默认四级版本前缀（与 init 示例阶段一致） */
+export const DEFAULT_STAGE_VERSION = 'v1.0.0';
+/**
+ * 解析 stageId → { series, stageDir, fullStageId }
+ *
+ * 支持三种格式（决策 2 正向映射）：
+ * - 完整：v1.0.0-stage-34 → { series: 'v1', stageDir: 'stage-34', fullStageId: 'v1.0.0-stage-34' }
+ * - 历史：v4-stage-04    → { series: 'v4', stageDir: 'stage-04', fullStageId: 'v4-stage-04' }
+ * - 短名：stage-01       → { series: 'v1', stageDir: 'stage-01', fullStageId: 'v1.0.0-stage-01' }
+ *
+ * 无法解析（如 'foo'、'v1'、空字符串）返回 null。
+ * 注意 stageDir 保留原始数字格式（stage-04 不丢前导零），NN 用捕获组原样保留，不做 parseInt。
+ */
+export function parseStageId(stageId) {
+    // 完整/历史格式：{version}-stage-{NN}，version 可为 v1.0.0（四级）或 v4（仅主版本）
+    const full = stageId.match(/^(v\d+(?:\.\d+)*)-stage-(\d+)$/);
+    if (full) {
+        const version = full[1]; // v1.0.0 或 v4
+        const stageDir = `stage-${full[2]}`;
+        const series = version.split('.')[0]; // v1 或 v4
+        return { series, stageDir, fullStageId: stageId };
+    }
+    // 短名格式：stage-{NN}
+    const short = stageId.match(/^stage-(\d+)$/);
+    if (short) {
+        const stageDir = `stage-${short[1]}`;
+        return {
+            series: DEFAULT_SERIES,
+            stageDir,
+            fullStageId: `${DEFAULT_STAGE_VERSION}-${stageDir}`,
+        };
+    }
+    return null;
+}
+/**
+ * stageId → plan 相对目录（不含 .openfeel 前缀）
+ * 例：v1.0.0-stage-34 → 'plan/v1/stage-34/'；stage-01 → 'plan/v1/stage-01/'
+ * 无法解析返回 null。
+ */
+export function stageIdToPlanDir(stageId) {
+    const parsed = parseStageId(stageId);
+    if (!parsed) {
+        return null;
+    }
+    return `plan/${parsed.series}/${parsed.stageDir}/`;
+}
+/**
+ * 短名/完整 stageId → 规范化完整 stageId
+ * 短名 stage-01 → v1.0.0-stage-01；完整/历史格式原样返回。
+ * 无法解析返回 null。
+ */
+export function normalizeStageId(stageId) {
+    const parsed = parseStageId(stageId);
+    return parsed ? parsed.fullStageId : null;
+}
+/**
+ * 目录名（stage-NN）→ 完整 stageId（反向映射，回查 flow.json stages 键）
+ *
+ * 目录名 stage-33 无法唯一还原版本前缀，须回查 flow.json 匹配 `*-stage-33`。
+ * 去歧义规则（遗留风险 1）：若多个 stageId 匹配 `*-stage-{NN}`，
+ *   1. 优先 pipeline.current.stage（若在匹配集中）；
+ *   2. 否则按版本前缀字典序降序取最新（v1.0.0 > v0.9 > v0.5）。
+ * 注：同 stage-NN 跨多版本前缀重复在理论上不应发生，此规则仅兜底。
+ *
+ * @returns 完整 stageId，找不到匹配或 flow.json 不可读时返回 null
+ */
+export function planDirToStageId(projectPath, stageDir) {
+    const flowPath = resolve(projectPath, '.openfeel', 'flow.json');
+    if (!existsSync(flowPath)) {
+        return null;
+    }
+    let flowData;
+    try {
+        flowData = JSON.parse(readFileSync(flowPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    const stages = flowData.stages ?? {};
+    const suffix = `-${stageDir}`; // -stage-33
+    const matches = Object.keys(stages).filter((k) => k.endsWith(suffix));
+    if (matches.length === 0) {
+        return null;
+    }
+    if (matches.length === 1) {
+        return matches[0];
+    }
+    // 去歧义：优先当前阶段，否则取版本字典序最新
+    const current = flowData.pipeline?.current?.stage;
+    if (current && matches.includes(current)) {
+        return current;
+    }
+    return matches.slice().sort().at(-1) ?? matches[0];
+}
+/**
+ * 三级回退查找 status.md（决策 4，供 flow-manager 与命令层复用）
+ *
+ * 1. plan/{series}/stage-NN/status.md（解析 stageId → 精确路径，首选）
+ * 2. plan/ 下递归搜索 stage-NN/status.md（fast-glob 递归，兼容 series 变化/旧平铺）
+ * 3. stages/{stageId}/status.md（历史遗留，只读兜底）
+ *
+ * 性能说明（遗留风险 3）：第 1 级精确路径命中率最高（新写入均在此），
+ * 第 2 级 fast-glob 仅在精确未命中时触发（兼容旧数据/系列变化的罕见场景），
+ * 因此对 flow status 高频调用性能影响可控；本 stage 不做缓存，留作后续观察。
+ *
+ * @returns status.md 绝对路径，三级均未命中返回 null
+ */
+export function findStageStatusPath(projectPath, stageId) {
+    const parsed = parseStageId(stageId);
+    if (parsed) {
+        // 1. 精确路径 plan/{series}/stage-NN/status.md
+        const exact = resolve(projectPath, '.openfeel', 'plan', parsed.series, parsed.stageDir, 'status.md');
+        if (existsSync(exact)) {
+            return exact;
+        }
+        // 2. 递归搜索 plan/**/stage-NN/status.md
+        const planDir = resolve(projectPath, '.openfeel', 'plan');
+        if (existsSync(planDir)) {
+            const matches = fastGlob.sync(`**/${parsed.stageDir}/status.md`, {
+                cwd: planDir,
+                onlyFiles: true,
+                caseSensitiveMatch: true,
+            });
+            if (matches.length > 0) {
+                return resolve(planDir, matches[0]);
+            }
+        }
+    }
+    // 3. 历史兜底 stages/{stageId}/status.md
+    const legacy = resolve(projectPath, '.openfeel', 'stages', stageId, 'status.md');
+    if (existsSync(legacy)) {
+        return legacy;
+    }
+    return null;
+}
+//# sourceMappingURL=path.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../src/core/plan/roadmap.ts"],"names":[],"mappings":"AAOA,WAAW;AACX,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAoCxE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BzE"}
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../src/core/plan/roadmap.ts"],"names":[],"mappings":"AAQA,WAAW;AACX,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAoCxE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BzE"}

package/dist/core/plan/roadmap.js

@@ -2,8 +2,9 @@
  * 分期大纲管理
  * 负责 .openfeel/roadmap/ 下的版本大纲文件创建与读取
  */
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';
 import { resolve, join } from 'node:path';
+import { atomicWriteFileSync } from '../fs/atomic-write.js';
 /** 规范化版本号：去掉用户可能输入的前导 v */
 function normalizeVersion(version) {
     return version.replace(/^v/, '');
@@ -41,7 +42,7 @@ export function createRoadmap(projectPath, version) {
 
 > 待补充
 `;
-    writeFileSync(filePath, content, 'utf-8');
+    atomicWriteFileSync(filePath, content);
     console.log(`已创建分期大纲: v${ver}.md`);
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"roadmap.js","sourceRoot":"","sources":["../../../src/core/plan/roadmap.ts"],"names":[],"mappings":"AAAA;;;GAGG;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;AAS1C,2BAA2B;AAC3B,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,OAAe;IAChE,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiB/B,CAAC;IAEA,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAgB;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC9C,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"roadmap.js","sourceRoot":"","sources":["../../../src/core/plan/roadmap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAS5D,2BAA2B;AAC3B,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,OAAe;IAChE,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiB/B,CAAC;IAEA,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAgB;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC9C,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -8,21 +8,22 @@ export interface Scheme {
     title: string;
     /** Markdown 全文 */
     content: string;
-    /** 相对路径 .openfeel/stages/{stage}/ops/op-001_{title}.md */
+    /** 相对路径 .openfeel/plan/{series}/{stage}/ops/op-001_{title}.md */
     filePath: string;
 }
 /**
  * 创建操作方案
- * 在 .openfeel/stages/{stage}/ops/ 下创建 op-NNN_{title}.md
+ * 在 .openfeel/plan/{series}/{stage}/ops/ 下创建 op-NNN_{title}.md
  * NNN 自动递增（从该阶段的已有方案中计算）
  * 必须按固定模板生成，包含：目标、实施步骤（checkbox）、产出文件、自测清单、修正记录
  * 创建后自动同步到 flow.json（如果存在）
+ * @param stageName 阶段名（短名 stage-01 或完整 v1.0.0-stage-01 均可）
  * @returns opId（如 op-001）
  */
 export declare function createScheme(projectPath: string, stageName: string, title: string): string;
 /**
  * 读取操作方案
- * @param opId 操作ID（如 op-001）或完整 opId（如 stage-01.op-001）
+ * @param opId 操作ID（如 op-001）或完整 opId（如 stage-01.op-001 / v1.0.0-stage-01.op-001）
  * @returns Scheme 或 null
  */
 export declare function getScheme(projectPath: string, opId: string): Scheme | null;

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

@@ -1 +1 @@
-{"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../../../src/core/plan/scheme.ts"],"names":[],"mappings":"AASA,WAAW;AACX,MAAM,WAAW,MAAM;IACrB,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwB1F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4D1E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAyD7E"}
+{"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../../../src/core/plan/scheme.ts"],"names":[],"mappings":"AAaA,WAAW;AACX,MAAM,WAAW,MAAM;IACrB,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0HD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkC1F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+B1E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CA6E7E"}

package/dist/core/plan/scheme.js

@@ -1,11 +1,15 @@
 /**
- * 操作方案管理（Schemer 产出层）
- * 负责 .openfeel/stages/{stage}/ops/ 下的操作方案文件 CRUD
+ * 操作方案管理（openfeel-schemer 产出层）
+ * 负责 .openfeel/plan/{series}/{stage}/ops/ 下的操作方案文件 CRUD
  * 创建后自动同步到 flow.json 的 stages/{stage}.ops 中
  */
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';
 import { resolve, join } from 'node:path';
-import { FlowManager } from '../flow-manager.js';
+import { FlowManager, isFlowConcurrentError } from '../flow-manager.js';
+import { parseStageId } from './path.js';
+import { atomicWriteFileSync } from '../fs/atomic-write.js';
+import { withFileLock, projectLockPath } from '../fs/file-lock.js';
+import { reserveSequence } from '../fs/sequence.js';
 /**
  * 生成操作方案的固定 Markdown 模板
  */
@@ -15,7 +19,7 @@ function generateSchemeTemplate(opId, stageName, title) {
 - **阶段**：${stageName}
 - **状态**：pending
 - **前置**：无
-- **负责 Agent**：Executor
+- **负责 Agent**：openfeel-executor
 - **最多重试**：3
 
 ## 目标
@@ -52,29 +56,14 @@ function extractTitle(fileName) {
     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')}`;
+/** 序号 → opId（3 位补零） */
+function opIdOf(seq) {
+    return `op-${String(seq).padStart(3, '0')}`;
 }
 /**
  * 同步方案到 flow.json
  * 若 flow.json 不存在或对应 stage 不存在，跳过同步（不报错）
+ * @param stageName 完整 stageId（如 v1.0.0-stage-01，调用方已规范化）
  */
 function syncToFlowJson(projectPath, stageName, opId, title) {
     const flowJsonPath = resolve(projectPath, '.openfeel', 'flow.json');
@@ -103,7 +92,7 @@ function syncToFlowJson(projectPath, stageName, opId, title) {
             id: opId,
             title,
             state: 'pending',
-            assignee: 'Executor',
+            assignee: 'openfeel-executor',
             attempts: 0,
             max_attempts: 3,
             checkpoints: {
@@ -116,91 +105,88 @@ function syncToFlowJson(projectPath, stageName, opId, title) {
         };
         flowMgr.save();
     }
-    catch {
-        // 同步失败不阻塞方案创建（静默忽略）
+    catch (err) {
+        // 并发冲突：op 文件已创建，但 flow.json 注册失败；不静默吞错，告警并提示兜底
+        if (isFlowConcurrentError(err)) {
+            console.warn(`[WARN] op ${opId} 已创建，但 flow.json 同步因并发冲突失败；` +
+                `请执行 openfeel flow repair 兜底或重新注册该 op。`);
+            return;
+        }
+        // 其它同步失败不阻塞方案创建（既有语义：静默忽略）
     }
 }
 /**
  * 创建操作方案
- * 在 .openfeel/stages/{stage}/ops/ 下创建 op-NNN_{title}.md
+ * 在 .openfeel/plan/{series}/{stage}/ops/ 下创建 op-NNN_{title}.md
  * NNN 自动递增（从该阶段的已有方案中计算）
  * 必须按固定模板生成，包含：目标、实施步骤（checkbox）、产出文件、自测清单、修正记录
  * 创建后自动同步到 flow.json（如果存在）
+ * @param stageName 阶段名（短名 stage-01 或完整 v1.0.0-stage-01 均可）
  * @returns opId（如 op-001）
  */
 export function createScheme(projectPath, stageName, title) {
-    // 1. 确保 .openfeel/stages/{stage}/ops/ 目录存在
-    const opsDir = resolve(projectPath, '.openfeel', 'stages', stageName, 'ops');
+    // 解析 stageId（短名/完整）得到 series + stageDir + 完整 ID
+    const parsed = parseStageId(stageName);
+    if (!parsed) {
+        throw new Error(`非法阶段名: ${stageName}（应为 stage-NN 或 vX.Y.Z.W-stage-NN）`);
+    }
+    // 1. 确保 .openfeel/plan/{series}/{stageDir}/ops/ 目录存在
+    const opsDir = resolve(projectPath, '.openfeel', 'plan', parsed.series, parsed.stageDir, 'ops');
     if (!existsSync(opsDir)) {
         mkdirSync(opsDir, { recursive: true });
     }
-    // 2. 计算下一个 opId
-    const opId = getNextOpId(opsDir);
-    // 3. 生成模板内容并写入文件
-    // 文件名中空格用下划线替换
+    // 2. 锁内：原子占号 + 原子写 op 文件（临界区仅含占号与写文件，不含 flow 同步）
     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
+    const lockPath = projectLockPath(projectPath, `scheme-${parsed.stageDir}`);
+    const opId = withFileLock(lockPath, () => {
+        const reserved = reserveSequence({
+            dir: opsDir,
+            candidate: (seq) => `${opIdOf(seq)}_${safeTitle}.md`,
+            parse: (fileName) => {
+                const m = fileName.match(/^op-(\d+)/);
+                return m ? parseInt(m[1], 10) : null;
+            },
+        });
+        const content = generateSchemeTemplate(opIdOf(reserved.seq), parsed.fullStageId, title);
+        atomicWriteFileSync(reserved.path, content);
+        return opIdOf(reserved.seq);
+    });
+    // 3. 同步到 flow.json（键用完整 stageId；由 FlowManager.save 的 flow.lock 保护）
+    syncToFlowJson(projectPath, parsed.fullStageId, opId, title);
     return opId;
 }
 /**
  * 读取操作方案
- * @param opId 操作ID（如 op-001）或完整 opId（如 stage-01.op-001）
+ * @param opId 操作ID（如 op-001）或完整 opId（如 stage-01.op-001 / v1.0.0-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 targetStage = null;
     let targetOpId;
-    // 判断 opId 格式：包含 "." 则为完整格式 "stage-01.op-001"
-    const dotIdx = opId.indexOf('.');
-    if (dotIdx !== -1) {
-        targetStageName = opId.substring(0, dotIdx);
-        targetOpId = opId.substring(dotIdx + 1);
+    // 解析 opId：'{stage}.{op-XXX}' 或纯 '{op-XXX}'
+    // 用正则锚定尾部 .op-NNN，避免完整 stageId 版本号中的点号干扰
+    const match = opId.match(/^(.+)\.(op-\d+)$/);
+    if (match) {
+        targetStage = match[1];
+        targetOpId = match[2];
     }
     else {
-        targetStageName = ''; // 遍历所有阶段查找
+        targetStage = null;
         targetOpId = opId;
     }
-    // 读取 stages 目录下的子目录
-    const stageEntries = readdirSync(stagesDir, { withFileTypes: true });
-    for (const stageEntry of stageEntries) {
-        if (!stageEntry.isDirectory()) {
-            continue;
-        }
-        // 若指定了阶段名，只检查匹配的目录
-        if (targetStageName && stageEntry.name !== targetStageName) {
-            continue;
+    // 若指定阶段，解析出 stageDir 后遍历查找
+    let targetStageDir = null;
+    if (targetStage) {
+        const parsed = parseStageId(targetStage);
+        if (!parsed) {
+            return null; // 阶段名非法
         }
-        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;
+        targetStageDir = parsed.stageDir;
+    }
+    for (const scheme of listSchemes(projectPath, targetStageDir ?? undefined)) {
+        if (scheme.opId === targetOpId) {
+            return scheme;
         }
-        // 找到匹配文件，读取内容
-        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;
 }
@@ -209,44 +195,61 @@ export function getScheme(projectPath, opId) {
  * @param stageName 可选，不传则列出所有阶段的方案
  */
 export function listSchemes(projectPath, stageName) {
-    const stagesDir = resolve(projectPath, '.openfeel', 'stages');
+    const planDir = resolve(projectPath, '.openfeel', 'plan');
     const result = [];
-    if (!existsSync(stagesDir)) {
+    if (!existsSync(planDir)) {
         return result;
     }
-    // 若指定了阶段名，只遍历该阶段
-    const stageNames = [];
+    // 解析目标 stageDir（若指定阶段过滤）
+    let targetStageDir = null;
     if (stageName) {
-        stageNames.push(stageName);
-    }
-    else {
-        const stageEntries = readdirSync(stagesDir, { withFileTypes: true });
-        for (const entry of stageEntries) {
-            if (entry.isDirectory()) {
-                stageNames.push(entry.name);
-            }
+        const parsed = parseStageId(stageName);
+        if (!parsed) {
+            return result; // 阶段名非法时返回空
         }
+        targetStageDir = parsed.stageDir;
     }
-    for (const sn of stageNames) {
-        const opsDir = join(stagesDir, sn, 'ops');
-        if (!existsSync(opsDir)) {
+    // 遍历 plan/{series}/stage-NN/ 两层目录
+    const seriesEntries = readdirSync(planDir, { withFileTypes: true });
+    for (const seriesEntry of seriesEntries) {
+        if (!seriesEntry.isDirectory()) {
             continue;
         }
-        const opFiles = readdirSync(opsDir).filter((f) => f.endsWith('.md'));
-        for (const fileName of opFiles) {
-            const opId = extractOpId(fileName);
-            if (!opId) {
+        const seriesDir = join(planDir, seriesEntry.name);
+        let stageEntries;
+        try {
+            stageEntries = readdirSync(seriesDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const stageEntry of stageEntries) {
+            if (!stageEntry.isDirectory()) {
+                continue;
+            }
+            if (targetStageDir && stageEntry.name !== targetStageDir) {
+                continue;
+            }
+            const opsDir = join(seriesDir, stageEntry.name, 'ops');
+            if (!existsSync(opsDir)) {
                 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}`,
-            });
+            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: stageEntry.name,
+                    title: extractTitle(fileName),
+                    content,
+                    filePath: `.openfeel/plan/${seriesEntry.name}/${stageEntry.name}/ops/${fileName}`,
+                });
+            }
         }
     }
     // 按阶段名 + opId 排序