sdd-flow-kit 1.0.25 → 1.1.0

package/dist/steps/runPhaseAdvance.js

@@ -0,0 +1,195 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPhaseAdvance = runPhaseAdvance;
+const path_1 = __importDefault(require("path"));
+const runGate_1 = require("./runGate");
+const resolveRun_1 = require("./resolveRun");
+const sessionState_1 = require("../core/sessionState");
+const fs_1 = require("../core/fs");
+const gitDiffGuard_1 = require("../core/gitDiffGuard");
+async function writeNextMd(outputRoot, lines) {
+    const body = ["# NEXT（脚本门禁 — 请按顺序执行）", "", ...lines, ""].join("\n");
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "NEXT.md"), body);
+}
+/**
+ * 阶段推进：先跑 gate，通过后更新 .session-state.json 与 NEXT.md。
+ */
+async function runPhaseAdvance(options) {
+    const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
+    if (!loaded || !loaded.resolved || !loaded.session) {
+        return { ok: false, runId: null, message: "未找到 run 或 .session-state.json" };
+    }
+    const { resolved, session } = loaded;
+    const outputRoot = resolved.outputRoot;
+    const runId = resolved.runId;
+    let gate = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId,
+        expect: "prd-fetched",
+        change: options.change,
+    });
+    if (options.to === "after-prd") {
+        gate = await (0, runGate_1.runGate)({ projectRoot: options.projectRoot, runId, expect: "prd-fetched" });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate prd-fetched 未通过" };
+        }
+        const next = {
+            ...session,
+            phase: "A",
+            status: "awaiting_user_confirmation",
+            docModeOnly: true,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, [
+                "## 当前：阶段 A（需求分析）",
+                "1. 执行 `02-需求分析提示词.md`",
+                "2. 若未闭合：仅更新 `03-待确认问题清单.md`，然后执行：",
+                "```bash",
+                `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect questions-open`,
+                "```",
+                "3. 用户确认后生成 01/02/04，再执行：",
+                "```bash",
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to docs-done`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: "已进入阶段 A（PRD 已就绪）" };
+    }
+    if (options.to === "docs-done") {
+        gate = await (0, runGate_1.runGate)({ projectRoot: options.projectRoot, runId, expect: "docs-closed" });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate docs-closed 未通过（禁止带 src 改动）" };
+        }
+        const next = {
+            ...session,
+            phase: "B",
+            status: "ready_for_propose",
+            docModeOnly: true,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, [
+                "## 当前：阶段 B 完成 → 进入 C（提案）",
+                "1. 执行 openspec propose（或）：",
+                "```bash",
+                `npx sdd-flow-kit propose --project-root ${options.projectRoot} --run-id ${runId} --change <kebab-name>`,
+                "```",
+                "2. 提案 apply-ready 后：",
+                "```bash",
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to propose-done --change <name>`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: "阶段 B 完成，可进入 propose" };
+    }
+    if (options.to === "propose-done") {
+        const changeName = options.change || session.activeChange;
+        if (!changeName) {
+            return { ok: false, runId, message: "需要 --change <name>" };
+        }
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "propose-ready",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate propose-ready 未通过" };
+        }
+        const next = {
+            ...session,
+            phase: "C",
+            status: "propose_done",
+            docModeOnly: true,
+            activeChange: changeName,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(options.projectRoot, ".opsx-active-change"), `${changeName}\n`);
+            const fe = path_1.default.join(options.projectRoot, "frontend", ".opsx-active-change");
+            await (0, fs_1.writeTextFileEnsuredDir)(fe, `${changeName}\n`).catch(() => undefined);
+            await writeNextMd(outputRoot, [
+                "## 当前：阶段 C 完成 → 进入 D（实现）",
+                "```bash",
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to impl --change ${changeName}`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: `提案就绪: ${changeName}` };
+    }
+    if (options.to === "impl") {
+        const changeName = options.change || session.activeChange;
+        if (!changeName) {
+            return { ok: false, runId, message: "需要 --change <name>" };
+        }
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "propose-ready",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "propose 未就绪，禁止进入实现" };
+        }
+        const gitRoot = (0, gitDiffGuard_1.resolveGitRoot)(path_1.default.join(options.projectRoot, "frontend") === path_1.default.join(options.projectRoot)
+            ? options.projectRoot
+            : path_1.default.join(options.projectRoot, "frontend"));
+        const head = (0, gitDiffGuard_1.gitDiffNameOnly)(gitRoot).head;
+        const next = {
+            ...session,
+            phase: "D",
+            status: "apply_in_progress",
+            docModeOnly: false,
+            activeChange: changeName,
+            implGitBaseline: head,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, [
+                "## 当前：阶段 D（允许修改 src/）",
+                "实现前门禁：",
+                "```bash",
+                `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect impl-allowed --change ${changeName}`,
+                "```",
+                "完成后交付：",
+                "```bash",
+                `npx sdd-flow-kit deliver --project-root ${options.projectRoot} --run-id ${runId} --change ${changeName}`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: "已进入实现阶段（docModeOnly=false）" };
+    }
+    if (options.to === "shipped") {
+        const changeName = options.change || session.activeChange;
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "shipped",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate shipped 未通过" };
+        }
+        const next = {
+            ...session,
+            phase: "done",
+            status: "complete",
+            docModeOnly: false,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, ["## ✅ SDD 流程已完成（delivery-pass）"]);
+        }
+        return { ok: true, runId, message: "流程完成" };
+    }
+    return { ok: false, runId, message: `未知 --to: ${options.to}` };
+}

package/dist/steps/runPropose.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPropose = runPropose;
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const resolveRun_1 = require("./resolveRun");
+const runGate_1 = require("./runGate");
+const fs_1 = require("../core/fs");
+const opsxDelivery_1 = require("../core/opsxDelivery");
+/**
+ * 创建/校验 openspec change，并检查 apply-ready（不代替 AI 写 proposal 正文，但强制 gate）。
+ */
+async function runPropose(options) {
+    const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
+    if (!(loaded === null || loaded === void 0 ? void 0 : loaded.resolved)) {
+        return { ok: false, detail: "未找到 PRD run" };
+    }
+    const docsGate = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId: loaded.resolved.runId,
+        expect: "docs-closed",
+    });
+    if (!docsGate.ok) {
+        (0, runGate_1.printGateResult)(docsGate);
+        return { ok: false, detail: "docs-closed gate 未通过，禁止 propose" };
+    }
+    const roots = [options.projectRoot, path_1.default.join(options.projectRoot, "frontend")];
+    let cwd = options.projectRoot;
+    for (const r of roots) {
+        if (await (0, opsxDelivery_1.pathExists)(path_1.default.join(r, "openspec"))) {
+            cwd = r;
+            break;
+        }
+    }
+    if (options.dryRun) {
+        return { ok: true, detail: `dry-run: would openspec new change ${options.change}` };
+    }
+    const exists = (0, child_process_1.spawnSync)("openspec", ["status", "--change", options.change, "--json"], {
+        cwd,
+        encoding: "utf8",
+    });
+    if (exists.status !== 0) {
+        const created = (0, child_process_1.spawnSync)("openspec", ["new", "change", options.change], {
+            cwd,
+            stdio: "inherit",
+        });
+        if (created.status !== 0) {
+            return { ok: false, detail: `openspec new change 失败: ${options.change}` };
+        }
+    }
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(cwd, ".opsx-active-change"), `${options.change}\n`);
+    const proposeNote = [
+        "# Propose 脚本检查点",
+        "",
+        `change: \`${options.change}\``,
+        "",
+        "AI 须按 openspec-propose skill 生成 proposal/design/specs/tasks，完成后执行：",
+        "```bash",
+        `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${loaded.resolved.runId} --expect propose-ready --change ${options.change}`,
+        `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${loaded.resolved.runId} --to propose-done --change ${options.change}`,
+        "```",
+        "",
+    ].join("\n");
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(loaded.resolved.outputRoot, "05-openspec-提案草稿.md"), proposeNote);
+    const ready = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId: loaded.resolved.runId,
+        expect: "propose-ready",
+        change: options.change,
+    });
+    (0, runGate_1.printGateResult)(ready);
+    if (!ready.ok) {
+        return {
+            ok: false,
+            detail: "change 已创建，但尚未 apply-ready；请生成 artifacts 后重跑 gate propose-ready",
+        };
+    }
+    return { ok: true, detail: `change ${options.change} apply-ready` };
+}

package/dist/steps/setupProject.js

@@ -4,19 +4,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupProject = setupProject;
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = __importDefault(require("node:path"));
-const promises_1 = require("node:readline/promises");
-const node_process_1 = __importDefault(require("node:process"));
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 const fs_1 = require("../core/fs");
+const readlinePrompt_1 = require("../core/readlinePrompt");
+const utils_1 = require("../core/utils");
 const opsxDelivery_1 = require("../core/opsxDelivery");
 const templates_1 = require("../core/templates");
 const EDITOR_CHOICES = ["claude-code", "cursor", "codex", "openclaw"];
 const PROJECT_CHOICES = ["OMS", "ADI", "欢盟", "AD Tools"];
 function runGit(args, cwd) {
-    const out = (0, node_child_process_1.spawnSync)("git", args, { cwd, encoding: "utf8" });
+    var _a, _b;
+    const out = (0, child_process_1.spawnSync)("git", args, { cwd, encoding: "utf8" });
     if (out.status !== 0) {
-        const err = out.stderr?.trim() || out.stdout?.trim() || `git ${args.join(" ")} failed`;
+        const err = ((_a = out.stderr) === null || _a === void 0 ? void 0 : _a.trim()) || ((_b = out.stdout) === null || _b === void 0 ? void 0 : _b.trim()) || `git ${args.join(" ")} failed`;
         throw new Error(err);
     }
     return out.stdout.trim();
@@ -45,9 +47,9 @@ function listLocalBranches(projectRoot) {
     }
 }
 async function askAgent(defaultAgent) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultAgent;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
     const prompt = [
         "请选择开发环境：",
         "1) claude-code (default)",
@@ -56,7 +58,7 @@ async function askAgent(defaultAgent) {
         "4) openclaw",
         "输入编号（回车默认 1）：",
     ].join("\n");
-    const answer = (await rl.question(`${prompt}\n`)).trim();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `${prompt}\n`)).trim();
     rl.close();
     if (!answer)
         return defaultAgent;
@@ -66,17 +68,17 @@ async function askAgent(defaultAgent) {
     return EDITOR_CHOICES[idx - 1];
 }
 async function askBranch(defaultBranch) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultBranch;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
-    const answer = (await rl.question(`请输入开发分支（默认 ${defaultBranch}）：\n`)).trim();
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `请输入开发分支（默认 ${defaultBranch}）：\n`)).trim();
     rl.close();
     return answer || defaultBranch;
 }
 async function askProjectKind(defaultKind) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultKind;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
     const prompt = [
         "请选择当前项目类型（用于生成 PRD 下载 skill）：",
         "1) OMS (default)",
@@ -85,7 +87,7 @@ async function askProjectKind(defaultKind) {
         "4) AD Tools",
         "输入编号（回车默认 1）：",
     ].join("\n");
-    const answer = (await rl.question(`${prompt}\n`)).trim();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `${prompt}\n`)).trim();
     rl.close();
     if (!answer)
         return defaultKind;
@@ -114,7 +116,7 @@ function skillInstallPath(projectRoot, agent) {
     const rel = relMap[agent];
     if (!rel)
         return null;
-    return node_path_1.default.join(projectRoot, rel);
+    return path_1.default.join(projectRoot, rel);
 }
 function allSkillInstallPaths(projectRoot) {
     const agents = ["cursor", "claude-code", "codex", "openclaw"];
@@ -135,19 +137,19 @@ async function installAgentSkill(projectRoot) {
                 : target.includes("/.codex/")
                     ? "codex"
                     : "openclaw";
-        const content = template.replaceAll("{{AGENT_NAME}}", agentName);
+        const content = (0, utils_1.replaceAllStr)(template, "{{AGENT_NAME}}", agentName);
         await (0, fs_1.writeTextFileEnsuredDir)(target, content);
     }
 }
 async function installSddCursorRule(projectRoot) {
-    const rulePath = node_path_1.default.join(projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc");
+    const rulePath = path_1.default.join(projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc");
     const template = await (0, templates_1.loadTemplateText)("rules/sdd-no-implement-until-apply.mdc.template");
     await (0, fs_1.writeTextFileEnsuredDir)(rulePath, template);
 }
 function renderVars(template, vars) {
     let out = template;
     for (const [k, v] of Object.entries(vars)) {
-        out = out.replaceAll(`{{${k}}}`, v);
+        out = (0, utils_1.replaceAllStr)(out, `{{${k}}}`, v);
     }
     return out;
 }
@@ -166,7 +168,7 @@ function docSkillDirName(kind) {
 }
 async function installDocsSkill(projectRoot, kind) {
     const { dir, prefix } = docSkillDirName(kind);
-    const docsDir = node_path_1.default.join(projectRoot, "docs", dir);
+    const docsDir = path_1.default.join(projectRoot, "docs", dir);
     const pyTemplate = await (0, templates_1.loadTemplateText)("skills/confluence-doc.py.template");
     const mdTemplate = await (0, templates_1.loadTemplateText)("skills/doc-skill.SKILL.md.template");
     const md = renderVars(mdTemplate, {
@@ -176,9 +178,9 @@ async function installDocsSkill(projectRoot, kind) {
         PRODUCT_PREFIX_LOWER: prefix.toLowerCase(),
         SKILL_DIR: dir,
     });
-    const py = pyTemplate.replaceAll("{{DOC_PRODUCT_PREFIX}}", prefix);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(docsDir, "SKILL.md"), md);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(docsDir, "confluence-doc.py"), py);
+    const py = (0, utils_1.replaceAllStr)(pyTemplate, "{{DOC_PRODUCT_PREFIX}}", prefix);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(docsDir, "SKILL.md"), md);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(docsDir, "confluence-doc.py"), py);
     return { dirPath: docsDir };
 }
 function getOpsxPathsByAgent(agent) {
@@ -196,7 +198,7 @@ function getOpsxPathsByAgent(agent) {
     }
 }
 async function installOpsxConfig(projectRoot, agent) {
-    const target = node_path_1.default.join(projectRoot, ".opsx", "config.json");
+    const target = path_1.default.join(projectRoot, ".opsx", "config.json");
     const resolvedAgent = await (0, opsxDelivery_1.resolveOpsxAgent)(projectRoot, agent);
     const paths = getOpsxPathsByAgent(resolvedAgent);
     const config = {
@@ -216,11 +218,12 @@ async function installOpsxConfig(projectRoot, agent) {
     await (0, fs_1.writeTextFileEnsuredDir)(target, JSON.stringify(config, null, 2));
 }
 async function setupProject(options) {
-    const defaultAgent = options.agent ?? "claude-code";
+    var _a, _b, _c;
+    const defaultAgent = (_a = options.agent) !== null && _a !== void 0 ? _a : "claude-code";
     const selectedAgent = options.yes ? defaultAgent : await askAgent(defaultAgent);
-    const defaultKind = options.projectKind ?? "OMS";
+    const defaultKind = (_b = options.projectKind) !== null && _b !== void 0 ? _b : "OMS";
     const selectedKind = options.yes ? defaultKind : await askProjectKind(defaultKind);
-    const defaultBranch = options.branch ?? pickDefaultBranch(options.projectRoot);
+    const defaultBranch = (_c = options.branch) !== null && _c !== void 0 ? _c : pickDefaultBranch(options.projectRoot);
     const selectedBranch = options.yes ? defaultBranch : await askBranch(defaultBranch);
     const plannedActions = [];
     const branches = listLocalBranches(options.projectRoot);
@@ -268,9 +271,9 @@ async function setupProject(options) {
             plannedActions.push(`would install skill: ${skillPath}`);
         }
         const { dir } = docSkillDirName(selectedKind);
-        plannedActions.push(`would install docs skill: ${node_path_1.default.join(options.projectRoot, "docs", dir)}`);
-        plannedActions.push(`would install opsx config: ${node_path_1.default.join(options.projectRoot, ".opsx", "config.json")}`);
-        plannedActions.push(`would install cursor rule: ${node_path_1.default.join(options.projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
+        plannedActions.push(`would install docs skill: ${path_1.default.join(options.projectRoot, "docs", dir)}`);
+        plannedActions.push(`would install opsx config: ${path_1.default.join(options.projectRoot, ".opsx", "config.json")}`);
+        plannedActions.push(`would install cursor rule: ${path_1.default.join(options.projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
     }
     else {
         await installAgentSkill(options.projectRoot);
@@ -304,7 +307,7 @@ async function setupProject(options) {
         ...plannedActions.map((x) => `- ${x}`),
         "",
     ].join("\n");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(options.projectRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(options.projectRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
     return {
         agent: selectedAgent,
         projectKind: selectedKind,

package/dist/steps/startFlow.js

@@ -4,24 +4,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startFlowScaffold = startFlowScaffold;
-const node_path_1 = __importDefault(require("node:path"));
-const promises_1 = __importDefault(require("node:fs/promises"));
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
 const utils_1 = require("../core/utils");
 const fs_1 = require("../core/fs");
 const templates_1 = require("../core/templates");
 const inferProject_1 = require("../core/inferProject");
+const sessionState_1 = require("../core/sessionState");
+const writeNext_1 = require("../core/writeNext");
 function renderTemplate(template, vars) {
     let out = template;
     for (const [k, v] of Object.entries(vars)) {
-        out = out.replaceAll(`{{${k}}}`, v);
+        out = (0, utils_1.replaceAllStr)(out, `{{${k}}}`, v);
     }
     return out;
 }
 async function startFlowScaffold(options) {
     const now = new Date();
     const runId = `${(0, utils_1.formatYYYYMMDD)(now)}-${options.product}-${options.version}`;
-    const outputRoot = node_path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
-    const sourceDir = node_path_1.default.join(outputRoot, "source");
+    const outputRoot = path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
+    const sourceDir = path_1.default.join(outputRoot, "source");
     await promises_1.default.mkdir(sourceDir, { recursive: true });
     // 1) Step1: doc-skill 指引（按产品解析脚本路径，支持 monorepo frontend）
     const kind = (0, inferProject_1.productToKind)(options.product);
@@ -33,23 +35,23 @@ async function startFlowScaffold(options) {
         DOC_SKILL_REL: docSkill.relFromRoot.replace(/\\/g, "/"),
         VERSION_EXAMPLE: options.version,
     });
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "01-获取需求文档指引.md"), step1);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "01-获取需求文档指引.md"), step1);
     // source 占位：让第 2 步提示词在任何工具里都能直接读
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "PRD.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "PRD.md"), [
         "# source/PRD.md",
         "",
         "请把《PRD》markdown 内容粘贴到这里（由 `adi-doc-skill` 下载并回填）。",
         "",
         "- 建议：保持原有标题层级与编号。",
     ].join("\n"));
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "接口文档.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "接口文档.md"), [
         "# source/接口文档.md",
         "",
         "（可选）如果你已经有接口文档，请粘贴到这里；没有也不影响后续 SDD 循环。",
         "",
         "- 注意：接口文档中的字段/示例越完整，分析报告越贴近落地。",
     ].join("\n"));
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "openspec-knowledge-base-summary.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "openspec-knowledge-base-summary.md"), [
         "# source/openspec-knowledge-base-summary.md",
         "",
         "（可选）现有知识库摘要/快速索引，建议由你在执行第 2 步前手动整理。",
@@ -60,35 +62,32 @@ async function startFlowScaffold(options) {
     const sddLoopPrompt = await (0, templates_1.loadTemplateText)("prompts/02-sdd-loop-prompt.md");
     const step2PromptTemplate = await (0, templates_1.loadTemplateText)("artifacts/02-需求分析提示词.template.md");
     const step2Prompt = renderTemplate(step2PromptTemplate, { SDD_LOOP_PROMPT: sddLoopPrompt });
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "02-需求分析提示词.md"), step2Prompt);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "02-需求分析提示词.md"), step2Prompt);
     // 3) Step2 输出文件占位（由 AI 工具生成并覆盖）
     const file01Template = await (0, templates_1.loadTemplateText)("artifacts/01-需求分析报告.template.md");
     const file02Template = await (0, templates_1.loadTemplateText)("artifacts/02-改动点清单.template.md");
     const file03Template = await (0, templates_1.loadTemplateText)("artifacts/03-待确认问题清单.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "01-需求分析报告.md"), file01Template);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "02-改动点清单.md"), file02Template);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "03-待确认问题清单.md"), file03Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "01-需求分析报告.md"), file01Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "02-改动点清单.md"), file02Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "03-待确认问题清单.md"), file03Template);
     // 4) Step4 技术文档入口（草稿）
     const techDocTemplate = await (0, templates_1.loadTemplateText)("artifacts/04-技术文档.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "04-技术文档草稿.md"), techDocTemplate);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "04-技术文档草稿.md"), techDocTemplate);
     // 5) Step5 openspec 提案入口（草稿）
     const openspecEntryTemplate = await (0, templates_1.loadTemplateText)("artifacts/05-openspec-提案草稿.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "05-openspec-提案草稿.md"), openspecEntryTemplate);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "05-openspec-提案草稿.md"), openspecEntryTemplate);
     const opsxAutoChainTemplate = await (0, templates_1.loadTemplateText)("artifacts/06-opsx-auto-chain.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "06-opsx-自动串联指引.md"), opsxAutoChainTemplate);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, ".session-state.json"), JSON.stringify({
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "06-opsx-自动串联指引.md"), opsxAutoChainTemplate);
+    const session = (0, sessionState_1.defaultSession)({
         product: options.product,
         version: options.version,
         runId,
         outputRoot,
-        status: "awaiting_user_confirmation",
-        docModeOnly: true,
-        autoChainOpsx: true,
-        phase: "A_or_B",
-        createdAtISO: new Date().toISOString(),
-    }, null, 2));
+    });
+    await (0, sessionState_1.writeSession)(outputRoot, session);
+    await (0, writeNext_1.writeInitialNext)(outputRoot, options.projectRoot, runId);
     // runDir 自述
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "RUNME.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "RUNME.md"), [
         "# RUNME（SDD 流程执行说明）",
         "",
         `本次 runId: \`${runId}\``,
@@ -113,16 +112,11 @@ async function startFlowScaffold(options) {
         "- `02-改动点清单.md`",
         "- `04-技术文档草稿.md`",
         "",
-        "## Step 5–6：自动串联 OPSX（默认）",
-        "03 闭环且 01/02/04 完成后，**同一 AI 回合**读 `06-opsx-自动串联指引.md`：",
-        "1. `/opsx-propose`（输入 01、02、UI；UI 默认读 `source/PRD.md` 原型目录）",
-        "2. 提案 apply-ready 后立即 `/opsx-apply` + `pnpm run opsx:delivery-pipeline`（exit 0）",
-        "勿停下来问「是否继续」。仅当用户说「只提案」或 `.session-state.json` 中 `autoChainOpsx: false` 时暂停。",
+        "## Step 5–6：脚本门禁（禁止仅靠自然语言跳步）",
+        "每一步必须先执行 `NEXT.md` 中的 `npx sdd-flow-kit gate` / `phase advance` / `propose` / `deliver`。",
+        "命令失败 (exit≠0) 时 **不得** 改 `src/` 或宣称完成。",
         "",
-        "## Step 6 明细：Apply + TDD + Playwright（阶段 D）",
-        "依次执行 skill：`openspec-apply-change` → `tdd-script` → `openspec-superpowers-pipeline` → `opsx-dev-delivery-pipeline`。",
-        "仓库根执行：`pnpm run opsx:delivery-pipeline -- <change-name>`（须 exit 0）。",
-        "禁止跳过 TDD / Playwright 裸写代码收尾。详见 `.cursor/skills/sdd-flow-kit/SKILL.md` 阶段 D。",
+        "详见：`NEXT.md`、`06-opsx-自动串联指引.md`、`.cursor/skills/sdd-flow-kit/SKILL.md`。",
     ].join("\n"));
     return {
         runId,

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "sdd-flow-kit",
-  "version": "1.0.25",
+  "version": "1.1.0",
   "private": false,
   "description": "Cross-agent SDD automated development workflow kit (ADI/ADI-like).",
   "license": "MIT",
+  "engines": {
+    "node": ">=14.16.0"
+  },
   "type": "commonjs",
   "main": "dist/index.js",
   "files": [